hmmhmmhm/daiso-mcp

다이소·편의점 재고와 생활 정보를 AI에서 바로 조회하세요. 설치·API 키 없는 공개 MCP, 웹 링크 조회, CLI·Skill을 지원합니다.

Daiso MCP – AI 対応の小売・映画データサービス

概要 – 韓国の小売、位置情報、映画情報（Daiso、GS25、7-Eleven、CU、Olive Young、CGV、Megabox、Lotte Cinema など）を構造化 API 呼び出しとして公開する、公開ホスト型の Model-Context-Protocol（MCP） サーバーです。このサービスは API キーやローカルインストールなしで アクセスできます – AI エージェント、チャットボット、開発者は MCP クライアントを https://mcp.aka.page に向け、提供されたツールを呼び出すだけです。

AI にとって重要な理由 – データは MCP 標準でパッケージ化されており、多くの LLM ベースのエージェント（Claude、ChatGPT、Home Assistant、Grok など）がネイティブに理解します。これにより、会話モデルは 「다이소 mcp로 수납박스 검색해줘」 のような質問をし、製品名、価格、店舗位置、在庫レベルを含むすぐに使用できる JSON 応答を受け取れます。カスタムスクレイピングや資格情報の処理は不要です。

コア機能

カテゴリ	サービス（ソース）	主なクエリ
場所	Naver ローカル検索	近くのレストラン、カフェ、デザート、その他の関心ポイント
交通	오피넷（オイル価格ネットワーク）	全国平均燃料価格、最安のガソリンスタンド、ステーションごとの詳細
小売比較	Daiso、GS25、7-Eleven、이마트24	同じ製品の店舗間価格比較
店舗データ	Daiso、Olive Young	製品カタログ、店舗リスト、在庫状況
コンビニデータ	GS25、7-Eleven、CU、이마트24	製品リスト、店舗リスト、在庫、人気検索語、カタログ
映画	CGV、Megabox、Lotte Cinema、D-trix（インディー映画館）	劇場、映画、上映時間、残り座席

すべてのエンドポイントは 標準 MCP 応答モデル（standard.products、standard.stores、standard.theaters）に従います。

使用方法

1. 直接 MCP 接続（インストール不要）

AI アプリで、URL https://mcp.aka.page、トランスポート HTTP / Streamable HTTP のリモート MCP サーバーを追加します。
モデルに自然言語リクエストを送信します。例：
```
다이소 mcp로 수납박스 검색해줘
```
エージェントはツール daiso_search_products を {"query":"수납박스"} で呼び出し、一致するアイテムと価格の構造化リストを返します。

2. HTTP POST 例（JSON-RPC を送信できる任意の端末またはツール）

curl -sS -N https://mcp.aka.page/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"daiso_search_products","arguments":{"query":"수납박스","pageSize":1}}}'

成功応答には result.structuredContent（または result.content）に製品データが含まれます。

3. CLI（オプション）– `npx daiso`

ローカルコマンドラインを好む場合は、次を実行します：

npx daiso products 수납박스 --json

CLI は同じリモート MCP サーバーと通信しますが、ワーカーをセルフホストすることもできます（貢献を参照）。

4. Codex Skill

CLI コマンドを実行できるエージェント向けに、ClawHub を介してスキルをインストールします：

clawhub install daiso-cli

スキルは自然言語の意図を適切な daiso CLI 呼び出しにマッピングします。

制限と信頼性

Olive Young、CGV、CU、GS25 の公開 GET API は IP ごとに 1 日 3,000 回の呼び出し（KST）に制限されています。制限を超える場合は、独自のインスタンスをホストしてください（リポジトリは MIT ライセンス）。
詳細なクォータ表とヘルスチェックドキュメントは docs/health-check-stock-and-quota.md と scripts/ops/README.md にあります。
リアルタイムサービスステータス：https://aka-page.betteruptime.com/。

ローカルでの開始（独自サーバーが必要な場合）

リポジトリをクローンします。
Cloudflare Worker daiso-mcp をデプロイします（プロジェクトには wrangler.toml が含まれています）。
サーバーは同じ MCP プロトコルで実行されるため、AI クライアントを独自の URL に向けることができます。

ドキュメントと参考資料

クライアントガイド – アプリ、CLI、Skill、OpenAPI の接続方法：docs/client-guide.md
サービスリファレンス – ツール、パラメータ、応答スキーマの完全なリスト：docs/service-reference.md
AI 指示 – エージェント向けの推奨プロンプトフロー：docs/ai-instruction.md
Web ディスカバリー – 公開フロントページの仕組み：docs/web-discovery.md
貢献ガイド – ビルド、テスト、デプロイ：CONTRIBUTING.md

要約

Daiso MCP = 韓国の小売、燃料価格、映画データを公開する、すぐに使えるキーレス MCP サーバー。
LLM エージェントを https://mcp.aka.page（またはセルフホスト）に接続し、自然言語クエリを送信します。モデルは構造化 JSON 結果を受け取ります。
オプションの CLI（npx daiso）と Codex Skill（clawhub install daiso-cli）は、ターミナルまたはエージェントツールキットで同じ機能を提供します。
カジュアルな使用は無料。より高いトラフィックにはセルフホスティングが必要です（MIT ライセンス）。

ライセンス：MIT ホスト：Cloudflare Workers（README にバッジ表示） ステータス：稼働中、Better Stack によるアップタイム監視あり。