Back to Details

unsplash

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Unsplash Skill

Unsplash Skill

Overview

概述

Enables Claude to use Unsplash for finding and downloading high-quality, royalty-free images for design projects, presentations, and content creation.
让Claude能够使用Unsplash为设计项目、演示文稿和内容创作查找并下载高质量、免版税的图片。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/unsplash/install.sh | bash
Or manually:
bash
cp -r skills/unsplash ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/unsplash/install.sh | bash
或手动安装：
bash
cp -r skills/unsplash ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置：
bash
undefined

First, ensure canifi-env is installed:

首先，确保canifi-env已安装：

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

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

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

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭据，由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:
  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
如果你不想与Claude Code共享凭据：
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录服务
  3. Claude将使用你的已认证会话，且永远不会看到你的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭据，可以将其存储在本地：
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意：存储在canifi-env中的凭据仅能在你的本地机器上访问，绝不会被传输。

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

示例1：查找项目图片

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
用户："为我的网站页眉找高质量的自然照片"
Claude：我将搜索自然主题的页眉图片。
1. 通过Playwright MCP打开Unsplash
2. 搜索"nature landscape header"
3. 按方向筛选（横向）
4. 预览热门结果
5. 以高分辨率下载选定图片

Example 2: Create Collection

示例2：创建合集

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
用户："将团队照片保存到名为'关于我们页面'的新合集中"
Claude：我会将照片整理到新合集中。
1. 创建名为"About Page"的新合集
2. 搜索专业团队照片
3. 将选定图片添加到合集中
4. 确认合集已准备就绪

Example 3: Download for Social Media

示例3：为社交媒体下载图片

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
用户："找一些抽象渐变背景用于Instagram"
Claude：我将查找抽象背景图。
1. 搜索"abstract gradient background"
2. 按调色板筛选
3. 以Instagram优化分辨率下载
4. 保存到你指定的文件夹

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
  1. 通过Playwright MCP导航至unsplash.com
  2. 点击“登录”并输入凭据
  3. 处理已配置的Google/SSO登录
  4. 保持会话以访问合集
  5. 跟踪下载归因要求

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
  • 登录失败：最多重试3次，通过iMessage通知
  • 会话过期：自动重新认证
  • 速率限制：实现指数退避策略
  • 下载失败：尝试使用不同分辨率重试
  • 搜索无结果：建议替代关键词
  • 合集已满：提示整理或升级

Self-Improvement Instructions

自我改进说明

When Unsplash updates features:
  1. Document new search filters and options
  2. Update download resolution options
  3. Track collection management changes
  4. Log API or rate limit adjustments
当Unsplash更新功能时：
  1. 记录新的搜索筛选条件和选项
  2. 更新下载分辨率选项
  3. 跟踪合集管理功能的变化
  4. 记录API或速率限制的调整

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
  • Unsplash图片免费使用但需要注明出处
  • 高分辨率下载可能耗时更长
  • 部分照片有使用限制
  • 即使登录用户也受API限制
  • 合集有助于整理项目资源