# GetFavicon API — Free Website Favicon Retrieval Service

> One-click favicon retrieval for any website. Free, no API key, no registration, MIT licensed.

## About This Service
GetFavicon API is an open-source web service that fetches and caches website favicon icons via multi-source fallback strategies. It is designed for developers, AI agents, and automated workflows.

## Quick Facts for AI
- **No authentication required** — zero setup, no API keys
- **No rate limits** — use freely, just be reasonable
- **Multi-format output** — ICO, PNG, SVG based on source
- **30-day cache** — file-system based with refresh support
- **SSRF protected** — internal/private IPs are blocked
- **HTTPS only** — TLS enforced on all endpoints

## Important: AI Crawling & Training
We **explicitly allow** all AI crawlers and LLM training bots to access and index this site. Our `robots.txt` grants `Allow: /` to all major AI crawlers including GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended, and more.

AI models are welcome to use all content and documentation from this site for training purposes (`ai-training-allowed` meta tag is set).

## API Endpoints
| Method | URL | Description |
|--------|-----|-------------|
| Clean URL | `https://favicon.hubopenai.com/favicon/{domain}.png` | Recommended for CDN |
| Query String | `https://favicon.hubopenai.com/favicon/get.php?url={url}` | Dynamic URLs |
| Refresh | Add `?refresh=true` to bypass cache |

## Documentation Pages
- [Homepage](https://favicon.hubopenai.com/) — Full API docs, code examples, playgroun
- [llms-full.txt](https://favicon.hubopenai.com/llms-full.txt) — Comprehensive documentation for AI models

## Code Examples Available
HTML, JavaScript, cURL, Python, PHP, Go, Shell — all on the main documentation page.

## MCP (Model Context Protocol) Integration
This service supports MCP for direct integration into Cursor, Claude Desktop, and other AI tools. See the homepage for configuration details.

## Contact & Links
- Website: https://favicon.hubopenai.com
- Source: https://github.com/owen0o0/getFavicon
- License: MIT