AI agents for Unsplash
Licensed imagery for generated content. AGNT connects to Unsplash so agents can read what happens there, reason about it, and act — with a receipt for every run.
Content Producer is a ready-made agent that works in Unsplash — free, and it runs on your machine.
Unsplash and AGNT, in brief
| What it does | Lets an AGNT agent read from and act in Unsplash. |
|---|---|
| Connects with | An API key held in the local vault |
| AGNT node | unsplash-api |
| Runs when | A schedule or another workflow fires it |
| Typical build time | Two minutes |
| Where data goes | Nowhere by default — AGNT runs on your machine and credentials never leave it. |
What you can automate
Agents can…
- search and fetch images
- attach imagery to drafts
Teams use it for
- posts illustrated automatically
- image options attached to drafts
- consistent visuals across channels
Build it: the Unsplash workflow
Take the simplest useful version: a scheduled run begins in Unsplash. Instead of a rule firing blindly, an agent reads the item in full, works out whether it matters and what it means, and then decides whether to search and fetch images. Over a week that turns posts illustrated automatically from something a person checks into something that reports to a person.
The shape is deliberately small. A trigger watching Unsplash, an agent that judges what arrived, and one action taken only when that judgment warrants it. Everything below is the actual definition, not an illustration of one.
{
"id": "d3ce775e-0363-4778-a7ac-f7daef839bf4",
"name": "Unsplash — read, decide, act",
"nodes": [
{
"id": "912d6013-4060-4d61-a204-099a07e5cc2a",
"text": "Run on a schedule",
"x": 512,
"y": 144,
"isEditing": false,
"type": "trigger-timer",
"icon": "clock",
"category": "trigger",
"isSelected": false,
"parameters": {
"interval": "15",
"unit": "minutes"
},
"description": "Checks Unsplash every fifteen minutes.",
"error": null,
"isActive": false,
"output": null,
"outputs": {}
},
{
"id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
"text": "Read it and decide",
"x": 512,
"y": 336,
"isEditing": false,
"type": "agnt-agent",
"icon": "agnt",
"category": "action",
"isSelected": false,
"parameters": {
"instructions": "Read the Unsplash item and decide whether it warrants action. Explain your reasoning."
},
"description": "Judges the Unsplash item against criteria you wrote in plain language.",
"error": null,
"isActive": false,
"output": null,
"outputs": {}
},
{
"id": "7bc51c68-dcf2-48db-a026-334f797f9f5e",
"text": "Act in Unsplash",
"x": 512,
"y": 528,
"isEditing": false,
"type": "unsplash-api",
"icon": "connect",
"category": "action",
"isSelected": false,
"parameters": {
"action": "SEARCH_PHOTOS"
},
"description": "Runs SEARCH_PHOTOS on your behalf.",
"error": null,
"isActive": false,
"output": null,
"outputs": {}
}
],
"edges": [
{
"id": "203cbfb9-60bd-479a-a448-2bcd7ec5174c",
"start": {
"id": "912d6013-4060-4d61-a204-099a07e5cc2a",
"type": "output"
},
"end": {
"id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
"type": "input"
},
"startX": 800,
"startY": 168,
"endX": 512,
"endY": 360
},
{
"id": "9ea4df40-d097-4c41-ad27-10a5173abdae",
"start": {
"id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
"type": "output"
},
"end": {
"id": "7bc51c68-dcf2-48db-a026-334f797f9f5e",
"type": "input"
},
"startX": 800,
"startY": 360,
"endX": 512,
"endY": 552
}
],
"zoomLevel": 1,
"canvasOffsetX": 0,
"canvasOffsetY": 0,
"isTinyNodeMode": false
}
Install Content Producer — it runs on Unsplash
Content Producer is a working agent that uses Unsplash. Installing it drops the whole workflow onto your canvas — connected, editable, and yours to change.
Runs on your own machine · See what it does
Imagery without the licensing question
Generated content usually needs a picture, and the picture is where publishing stalls. Pulling licensed imagery as part of the workflow keeps the draft complete rather than blocked on somebody finding something usable.
Consistency across channels
Because selection happens in the same workflow that produces the copy, visual treatment can stay consistent across every channel a piece goes to, instead of varying by whoever assembled each version.
Inside the Unsplash API node
Search and download high-quality stock photos from Unsplash.
What it can do: SEARCH_PHOTOS GET_RANDOM_PHOTO GET_PHOTO LIST_PHOTOS GET_COLLECTIONS GET_COLLECTION_PHOTOS GET_USER_PROFILE GET_USER_PHOTOS DOWNLOAD_PHOTO
Full Unsplash API parameter reference
| Parameter | Type | What it does |
|---|---|---|
actionrequired |
string | The action to perform on Unsplash SEARCH_PHOTOS · GET_RANDOM_PHOTO · GET_PHOTO · LIST_PHOTOS · GET_COLLECTIONS · GET_COLLECTION_PHOTOS · GET_USER_PROFILE · GET_USER_PHOTOS |
query |
string | Search query for photos only when action is SEARCH_PHOTOS or GET_RANDOM_PHOTO |
photoId |
string | The ID of the photo only when action is GET_PHOTO or DOWNLOAD_PHOTO |
collectionId |
string | The ID of the collection only when action is GET_COLLECTION_PHOTOS |
username |
string | Unsplash username only when action is GET_USER_PROFILE or GET_USER_PHOTOS or GET_RANDOM_PHOTO |
pagerequired |
number | Page number (1-1000) |
perPagerequired |
number | Results per page (1-30) |
orientationrequired |
string | Filter by photo orientation · landscape · portrait · squarish |
color |
string | Filter by color · black_and_white · black · white · yellow · orange · red · purple only when action is SEARCH_PHOTOS |
orderByrequired |
string | Sort order for results relevant · latest · oldest · popular |
count |
number | Number of random photos (1-30) only when action is GET_RANDOM_PHOTO |
featured |
string | Limit to featured photos only · true · false only when action is GET_RANDOM_PHOTO |
Every parameter above is read from the shipped unsplash-api node, so it cannot drift from the product.
Connect Unsplash in two minutes
- Download AGNT Community Core — free, local-first, no account needed to run.
- Connect by pasting an API key into AGNT’s vault — stored encrypted on your machine, never uploaded.
- Drop the Unsplash node into a workflow or hand it to an agent — the first run produces a receipt you can read line by line.
Unsplash + AGNT — common questions
Can images be attached to drafts automatically?
Yes — searched and attached as part of the content workflow.
Is attribution handled?
Attribution requirements come with the image; include them in your publishing step.
How is Unsplash connected?
With an API key stored encrypted in the local vault.