iconserve

IconServe

10,000 件以上のオープンソースアイコンを集約した、無料でエージェントが読み取れるサービスです。Lucide、 Heroicons、Tabler、Simple Iconsを 予測可能な URL でSVG または PNGとして提供します。キーワード検索とセマンティック検索、llms.txt、MCP サーバーにも対応しています。

すべてCloudflare の無料枠（Workers + R2 + Workers AI）内で動作します。

エージェントでの利用方法

必要なこと	操作
名前が分かっているアイコンを埋め込む	GET /i/{name}.svg（最適な候補）または /icons/{set}/{name}.svg
適切なアイコンを探す	GET /api/search?q=shopping+cart → 名前とすぐに使える URL
API 全体を一度に読む	GET /llms.txt（または /llms-full.txt）
ネイティブのツール呼び出し	/mcp の MCP サーバー（search_icons、get_icon、list_sets）
OpenAPI	GET /openapi.json

検出可能な情報（クロール／閲覧するエージェント向け）

• GET /icon/{set}/{name} — アイコンごとにクロール可能な HTML ページ（プレビュー、使用方法、JSON-LD ImageObject とパンくずリスト）。/icon/{name} は最適な候補へ 302 リダイレクトします。
• GET /sitemap.xml — すべてのアイコンページ（約 1 万件の URL）。
• GET /robots.txt — AI クローラー（GPTBot、OAI-SearchBot、ClaudeBot、PerplexityBot、Google-Extended、…）を明示的に許可し、サイトマップを示します。
• ランディングページには WebSite と SearchAction、WebAPI の JSON-LD、Open Graph タグが含まれます。
• IndexNow：キーのファイルは /{INDEXNOW_KEY}.txt で提供されます。npm run indexnow は Bing／Yandex に通知し、新規または変更された URL をすぐにクロールさせます（一部のパスだけを送信するには、npm run indexnow /icon/lucide/house のようにパスを指定します）。

変換（すべてのアイコン URL に指定できるクエリパラメーター）

• color= 16 進数／CSS カラー／currentColor — 例：?color=%23e11d48
• size= 1..2048 px
• stroke= 0..20（線画アイコン）
• style= 例：solid（Heroicons）、filled（Tabler）
• format= svg | png

例：/i/shopping-cart.svg?color=crimson&size=48&stroke=1.5

アーキテクチャ

Build (offline, on your machine — no Cloudflare cost)
  scripts/ingest.mjs  → data/pack/icons.json  (id → normalized SVG, currentColor-driven)
                        data/pack/catalog.json (names, tags, aliases, license, styles)
                        data/pack/corpus.json  (search text per icon)
  scripts/embed.mjs   → data/pack/embeddings.bin  (10k × 384, bge-small-en-v1.5)
                        data/pack/embed-index.json

Cloudflare
  R2 (ICONS)   holds the 4 packed artifacts; loaded once per isolate into memory
  Workers AI   embeds ONLY the query string at search time (same 384-dim model)
  Worker       routing, color/size/stroke transforms, PNG (resvg-wasm), search, MCP, docs
  Assets       public/index.html landing page

セマンティック検索では、キーワードのランキングとメモリ内の埋め込みベクトルに対するコサイン類似度を融合（逆順位融合）します。Vectorize は不要で、ベクトルごとの課金もなく、次元数の上限もありません。embeddings.bin が存在しない場合、検索は問題なくキーワードのみの方式に切り替わります。

ローカル開発

npm install
npm run build:data     # ingest + embed  (embed downloads a ~40MB model once)
npm run upload:r2      # push artifacts into the LOCAL R2 store
npm run dev            # http://localhost:8787

wrangler dev --local では Workers AI バインディングがオフラインのため、ローカルでの検索はキーワードのみで実行されます。 セマンティック検索は、デプロイ後（またはリモート AI バインディングに接続して実行した場合）に有効になります。

デプロイ（Cloudflare の無料枠）

wrangler login         # one-time, opens a browser
npm run deploy         # creates the R2 bucket, uploads artifacts, deploys the Worker

npm run deploy は scripts/deploy.mjs を実行します。iconserve-icons バケットを作成し（冪等）、4 つのアーティファクトをリモート R2 にアップロードしてから、wrangler deploy を実行します。

アイコンセットの追加／更新

scripts/lib/sets.mjs を編集し、npm run build:data && npm run upload:r2 （ローカル）または npm run deploy（リモート）を再実行します。/i/{name} の最適な候補を選ぶ優先順位は、 wrangler.toml の DEFAULT_SET_ORDER で設定します。

ライセンス

アイコンはそれぞれの元の寛容なライセンスに基づいて再配布されます。Lucide（ISC）、Heroicons（MIT）、 Tabler（MIT）、Simple Icons（CC0）。Simple Icons のブランドマークは各所有者の商標です。各ブランドのガイドラインに従って使用してください。