// Search for images on Unsplash and download them. Optionally add text overlay (title/subtitle) to the image. Use when the user asks to find a stock photo, search for an image, get an Unsplash image, or download a photo with text.
| name | unsplash-image |
| description | Search for images on Unsplash and download them. Optionally add text overlay (title/subtitle) to the image. Use when the user asks to find a stock photo, search for an image, get an Unsplash image, or download a photo with text. |
| argument-hint | ["search query"] |
| allowed-tools | Bash(*), Read, Write |
Search Unsplash for images, download them, and optionally add text overlay.
~/.agents/tools/unsplash-search.py~/.agents/tools/.env (contains UNSPLASH_CLIENT_ID)python ~/.agents/tools/unsplash-search.py \
--query "nature landscape" \
--output ./image.jpg
python ~/.agents/tools/unsplash-search.py \
--query "coffee shop" \
--orientation landscape \
--output ./coffee.jpg
python ~/.agents/tools/unsplash-search.py \
--query "technology abstract" \
--output ./cover.png \
--title "My Blog Post Title" \
--subtitle "A short description"
python ~/.agents/tools/unsplash-search.py \
--query "sunset" \
--list
python ~/.agents/tools/unsplash-search.py \
--query "mountains" \
--pick first \
--output ./mountains.jpg
| Option | Description |
|---|---|
--query, -q | (Required) Search query string |
--output, -o | (Required unless --list) Output file path |
--orientation | Filter: landscape, portrait, or squarish |
--color | Color filter (e.g., blue, green, red, black_and_white) |
--pick | How to select from results: random (default) or first |
--title | Title text to overlay on the image |
--subtitle | Subtitle text to overlay (only used with --title) |
--list | List search results instead of downloading |
--count | Number of results to fetch, max 30 (default: 30) |
When --title is provided, the script adds a text overlay to the bottom portion of the image with:
Requires Pillow: pip install Pillow
requests (for API calls and image download)Pillow (only needed if using text overlay with --title)Install if needed:
pip install requests Pillow
The script prints:
urls.full or urls.raw.Edit podcast audio — trim pre/post-show chat, remove filler words, cut silences, and enhance audio quality. Use when the user asks to edit a podcast, clean up audio, remove fillers, trim a recording, or improve voice quality.
Generate images using AI (OpenAI GPT Image or Stability AI). Use when the user asks to generate an image, create an AI image, make an illustration, or produce artwork from a text prompt.
Fight Stripe disputes and chargebacks by gathering evidence (Stripe API + your app database + terms page), generating an activity-log PDF, and submitting a counter-dispute. Use when the user says "fight dispute", "stripe dispute", "chargeback", "counter dispute", "dispute evidence", or shares a Stripe dispute ID.
Manages Ahrefs API usage in Python using `ahrefs-python` library. Use when working with SEO / marketing related tasks or with data including backlinks, keywords, domain ratings, organic traffic, site audits, rank tracking, and brand monitoring. Covers `ahrefs-python` usage including AhrefsClient / AsyncAhrefsClient, typed request/response models, error handling, and all API sections.
Fetch brand info (name, description, logos, industry) from brand.dev API and save logos locally. Use when the user asks to look up a brand, fetch a logo, get brand info, or add a company with its logo.
Fetch Google review ratings and review counts for businesses via DataForSEO API. Use when the user asks to check Google reviews, get review counts, compare business ratings, audit Google Maps presence, or analyze competitor reviews.