@skills.ai/open-image-finder

AI skill and CLI for finding free, licensed public images from open sources.

Usage

npx @skills.ai/open-image-finder "solar panels" --limit 5
npx @skills.ai/open-image-finder "solar panels" --limit 5 --source openverse --min-width 1200 --min-height 800

Output is JSON:

{
  "query": "solar panels",
  "count": 1,
  "results": [
    {
      "title": "Solar panels",
      "url": "https://example.com/image.jpg",
      "thumbnail": "https://example.com/thumb.jpg",
      "source": "Openverse",
      "author": "Example Author",
      "license": "by",
      "license_url": "https://creativecommons.org/licenses/by/2.0/",
      "attribution_required": true,
      "width": 1920,
      "height": 1080
    }
  ]
}

Options

• --limit 5 limits returned results.
• --source openverse|wikimedia|pexels|unsplash|all selects image sources.
• --min-width 1200 filters by minimum width.
• --min-height 800 filters by minimum height.
• --help or -h prints usage without running a search.

Sources

No API key needed:

• Openverse
• Wikimedia Commons

Optional API keys:

PEXELS_API_KEY=... npx @skills.ai/open-image-finder "office" --limit 5
UNSPLASH_ACCESS_KEY=... npx @skills.ai/open-image-finder "office" --limit 5

Skill file

Published skill description:

https://unpkg.com/@skills.ai/open-image-finder@latest/SKILL.md

Local development

npm run check
npm test
npm run smoke
npm pack --dry-run

Publish

npm publish --access public

License

MIT

Image licenses are owned by their original authors and sources. Always review the returned license_url before commercial use.