# Stocky Logo 斯托基 *查找精美的免版税库存图片* 📸
  
✨ 特性
- 🔍 多提供商搜索 -同时搜索Pexels和Unsplash
- 📊 元数据 -获取全面的图像详细信息，包括尺寸、摄影师信息和许可
- 📄 分页支持 -轻松浏览大型结果集
- 🛡️ 优雅的错误处理 -针对API故障的稳健错误处理
- ⚡ 异步性能 -Lightning-fast并发API调用
- 🎯 提供商灵活性 -搜索特定提供商或一次搜索所有提供商
美丽的库存照片触手可及\ 用于演示目的的示例图像
Mountain Landscape *通过多个提供商提供令人惊叹的景观*
🚀 快速开始
安装
- 克隆存储库：
git clone https://github.com/yourusername/stocky-mcp.git
cd stocky-mcp- 安装依赖项：
pip install -r requirements.txtAPI密钥设置
您将需要来自每个提供商的免费API密钥：
- 像素 📷 - 把钥匙拿到 pexels.com/api
- Unsplash 🌅 - 注册地址： unsplash.com/developers
API密钥配置
设置MCP服务器时，您需要配置API密钥。这些密钥用于与股票图像提供商进行身份验证。
作为MCP服务器运行
Stocky被设计为作为MCP（模型上下文协议）服务器运行，而不是作为独立应用程序运行。它应该在MCP客户端配置中配置。
🔧 MCP客户端配置
将Stocky添加到MCP客户端配置中：
{
"mcpServers": {
"stocky": {
"command": "python",
"args": ["/path/to/stocky_mcp.py"],
"env": {
"PEXELS_API_KEY": "your_pexels_key",
"UNSPLASH_ACCESS_KEY": "your_unsplash_key",
}
}
}
}📖 使用示例
Find the perfect image for your project
搜索图像
搜索所有提供商：
results = await search_stock_images("sunset beach")搜索特定提供商：
results = await search_stock_images(
query="mountain landscape",
providers=["pexels", "unsplash"],
per_page=30,
page=1
)获取图像详细信息
details = await get_image_details("unsplash_abc123xyz")下载图像
# Download and save to disk
result = await download_image(
image_id="pexels_123456",
size="medium",
output_path="/path/to/save.jpg"
)
# Get base64-encoded image data
result = await download_image(
image_id="unsplash_abc123",
size="original"
)🛠️ 工具文档
search_stock_images
在多个提供商中搜索免版税的库存图像。
参数：
query（str，必填）-查找图像的搜索词providers（列表，可选）-要搜索的提供商列表：["pexels", "unsplash"]per_page（int，可选）-每页最多50个结果（默认值：20）page（int，可选）-分页页码（默认值：1）sort_by（str，可选）-按“相关性”或“最新”对结果进行排序
退货： 带有元数据的图像结果列表
get_image_details
获取特定图像的详细信息。
参数：
image_id（str，必填）-图像ID格式provider_id（例如。，pexels_123456)
退货： 详细的图像信息，包括完整的元数据
download_image
将图像下载到本地存储或获取base64编码数据。
参数：
image_id（str，必填）-图像ID格式provider_id（例如。，pexels_123456)size（str，可选）-要下载的图像大小变量（默认值：“原始”）
- 选项：缩略图、小、中、大、原始
output_path（str，可选）-本地保存图像的路径
- 如果未提供，则返回base64编码的图像数据
退货： 有下载信息或错误的词典
📄 许可证信息
Royalty-free images for your creative projects
Stocky返回的所有图像均可免费使用：
- 像素 ✅ - 商业和个人使用免费，无需归因
- Unsplash ✅ - 根据Unsplash许可证免费
在生产中使用之前，始终检查每个图像的特定许可证。
🤝 贡献
欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
- 分叉项目
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支机构(
git push origin feature/AmazingFeature) - 打开拉取请求
🙏 致谢
🐛 故障排除
常见问题
“找不到API密钥”错误
- 确保您的
.env文件存在并且包含有效的API密钥 - 检查是否正确加载了环境变量
- 验证API密钥名称是否完全匹配（区分大小写）
未返回任何结果
- 尝试不同的搜索词
- 检查您的互联网连接
- 验证API密钥是否处于活动状态，并且没有超过速率限制
安装问题
- 确保已安装Python 3.8+
- 尝试创建虚拟环境：
python -m venv venv - 更新pip：
pip install --upgrade pip
速率限制
每个提供商都有不同的费率限制：
- 像素：每小时200个请求
- Unsplash：每小时50个请求（演示），每小时5000个请求（生产）
______________________________________________________________________
Made with 💜 by the Stocky Team
