Unsplash Skill

Overview

Quick Install

curl -sSL https://canifi.com/skills/unsplash/install.sh | bash

cp -r skills/unsplash ~/.canifi/skills/

Setup

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set UNSPLASH_EMAIL "your-email@example.com"
canifi-env set UNSPLASH_PASSWORD "your-password"

Privacy & Authentication

Option 1: Manual Browser Login (Recommended)

1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Capabilities

• Search photos by keyword and filters
• Download images in various resolutions
• Create and manage photo collections
• View photographer profiles
• Track download history
• Access curated editorial collections

Usage Examples

Example 1: Find Project Images

User: "Find high-quality nature photos for my website header"
Claude: I'll search for nature header images.
1. Opening Unsplash via Playwright MCP
2. Searching "nature landscape header"
3. Filtering by orientation (landscape)
4. Previewing top results
5. Downloading selected images in high resolution

Example 2: Create Collection

User: "Save team photos to a new collection called 'About Page'"
Claude: I'll organize photos into a new collection.
1. Creating new collection "About Page"
2. Searching for professional team photos
3. Adding selected images to collection
4. Confirming collection is ready for use

Example 3: Download for Social Media

User: "Get some abstract gradient backgrounds for Instagram"
Claude: I'll find abstract backgrounds.
1. Searching "abstract gradient background"
2. Filtering by color palette
3. Downloading in Instagram-optimized resolution
4. Saving to your designated folder

Authentication Flow

1. Navigate to unsplash.com via Playwright MCP
2. Click "Login" and enter credentials
3. Handle Google/SSO if configured
4. Maintain session for collections access
5. Track download attribution requirements

Error Handling

• Login Failed: Retry up to 3 times, notify via iMessage
• Session Expired: Re-authenticate automatically
• Rate Limited: Implement exponential backoff
• Download Failed: Retry with different resolution
• Search No Results: Suggest alternative keywords
• Collection Full: Prompt to organize or upgrade

Self-Improvement Instructions

1. Document new search filters and options
2. Update download resolution options
3. Track collection management changes
4. Log API or rate limit adjustments

Notes

• Unsplash images are free but require attribution
• High-resolution downloads may take longer
• Some photos have usage restrictions
• API limits apply even for logged-in users
• Collections help organize project assets