- Stocky
Stocky
What is Stocky?
Stocky is a tool designed to help users find beautiful royalty-free stock images by searching across multiple providers like Pexels and Unsplash simultaneously.
How to use Stocky?
To use Stocky, clone the repository, install the required dependencies, set up your API keys from Pexels and Unsplash, and run the server to start searching for images.
Key features of Stocky?
- 🔍 Multi-Provider Search: Search across Pexels and Unsplash simultaneously.
- 📊 Rich Metadata: Get comprehensive image details including dimensions, photographer info, and licensing.
- 📄 Pagination Support: Browse through large result sets with ease.
- 🛡️ Graceful Error Handling: Robust error handling for API failures.
- ⚡ Async Performance: Lightning-fast concurrent API calls.
- 🎯 Provider Flexibility: Search specific providers or all at once.
Use cases of Stocky?
- Finding high-quality images for blog posts.
- Sourcing images for marketing materials.
- Searching for specific themes or subjects in stock photography.
FAQ from Stocky?
- Can I use images from Stocky for commercial purposes?
Yes! All images returned by Stocky are free to use for commercial and personal use, but always check the specific license for each image before use in production.
- Do I need to pay for API keys?
No, both Pexels and Unsplash provide free API keys for developers.
- What should I do if I encounter an "API key not found" error?
Ensure your
.envfile exists and contains valid API keys, and check that environment variables are properly loaded.
Server Config
{
"mcpServers": {
"stocky": {
"command": "python",
"args": [
"/path/to/stocky_mcp.py"
],
"env": {
"PEXELS_API_KEY": "your_pexels_key",
"UNSPLASH_ACCESS_KEY": "your_unsplash_key"
}
}
}
}