Connect Unsplash to Your AI Agent

Ask your AI assistant to work with Unsplash: find photos and inspect image metadata.

6 tools API key

Try a Unsplash Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Unsplash

Find Photos for a Topic

Search photos and read selected metadata.

/oo Unsplash: Search Unsplash for [visual topic] using [orientation/filter preferences], inspect selected photo IDs, and summarize returned image URLs and author information.

Explore a Curated Topic

List topics before reading a selected collection.

/oo Unsplash: List Unsplash topics, select [topic name], and retrieve its photos for a reference shortlist.

Start Working with Unsplash

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Unsplash

    Connect using your Unsplash Access Key.

    Connect Unsplash →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • An account with access to the Unsplash resources used in your task.

Unsplash Tools

Unsplash exposes public photo search, topic collections, and detailed photo records for AI visual research.

Find Photos for a Topic

Search photos and read selected metadata.

Explore a Curated Topic

List topics before reading a selected collection.

6 tools

List Photos

List the latest public photos from Unsplash.

unsplash.list_photos

Search Photos

Search photos on Unsplash using keyword and filter inputs.

unsplash.search_photos

Get Photo

Fetch the detailed payload for a single Unsplash photo.

unsplash.get_photo

Get Random Photo

Fetch one or more random Unsplash photos using optional filters.

unsplash.get_random_photo

List Topics

List topics curated by Unsplash.

unsplash.list_topics

Get Topic Photos

List photos from a specific Unsplash topic.

unsplash.get_topic_photos

Frequently Asked Questions

Does this generate photos?

It retrieves existing Unsplash photos rather than generating new images.

Will search download the image file?

Actions return photo data and image URLs; file download is a separate step.

Can I choose random photos?

The random-photo action supports optional filters.

Connect Unsplash

About Unsplash ↗