blog image finder

Finding the right header image for a blog post is a time-consuming chore that often leads to copyright risks or repeated visuals. This skill automates the entire discovery and preparation pipeline, moving from a text topic to a legal, cropped, and optimized WebP image in seconds. It handles multi-source searching, deduplication, and license tracking so you never accidentally reuse an image or violate a TOS.

What it does

• Multi-source discovery queries Pexels, Pixabay, Unsplash, Openverse, and Wikimedia Commons simultaneously.
• Smart deduplication tracks every image used per site to ensure you never publish the same visual twice.
• Automated optimization crops images to specific ratios like 16:9, resizes for performance, and converts to WebP.
• Vision-based judging uses AI to inspect candidates for regional relevance, quality, and brand logos before selection.
• License management generates sidecar JSON files with author credits, source URLs, and specific attribution text.
• AI fallback generates custom editorial photographs via FLUX or Cloudflare if no suitable stock photo exists.

How it works

1. Source validation: Run the check command to verify API keys and provider availability.
2. Visual querying: The skill translates abstract article topics into concrete, searchable English scene descriptions.
3. Selection and processing: Use the pick command to find, download, crop, and record the chosen image for a specific site.
4. Integration: Embed the resulting file path, alt text, and attribution line directly into your article or CMS.

Frameworks & tools

Built with Python 3.10, utilizing Pillow for image processing and standard libraries for API orchestration. Integrates with OpenAI-compatible vision models for automated quality grading and supports NVIDIA FLUX and Cloudflare Workers AI for generation.

Why this beats prompting it yourself

Generic prompts often return abstract or low-quality stock results that require manual cropping and licensing checks. This skill enforces strict commercial license filters, manages a persistent local database of used images, and handles the technical conversion to modern web formats automatically.

Use cases

• Automating cover image selection for high-volume SEO blog networks.
• Sourcing legally compliant photography for commercial landing pages and newsletters.
• Wiring a programmatic content pipeline to a royalty-free image API.
• Replacing manual stock photo searches with specific AI-generated editorial visuals.

Known limitations

Unsplash images cannot be downloaded and must be hotlinked via URL. PIllow is required for local cropping and WebP conversion. Vision-based judging requires an external OpenAI-compatible API key.