hmmhmmhm/daiso-mcp

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

Daiso MCP – AI 就绪的零售与影院数据服务

它是什么 – 一个公开托管的 模型上下文协议（MCP） 服务器，将韩国零售、位置和影院信息（Daiso、GS25、7-Eleven、CU、Olive Young、CGV、Megabox、Lotte Cinema 等）作为结构化 API 调用暴露。该服务可以在 无需任何 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 应用中，添加一个远程 MCP 服务器，URL 为 https://mcp.aka.page，传输方式为 HTTP / Streamable HTTP。
向模型提出自然语言请求，例如：
```
다이소 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 服务器通信，但您也可以自托管 worker（参见贡献）。

4. Codex Skill

对于可以执行 CLI 命令的代理，通过 ClawHub 安装技能：

clawhub install daiso-cli

该技能将自然语言意图映射到相应的 daiso CLI 调用。

限制与可靠性

Olive Young、CGV、CU、GS25 的公共 GET API 限制为 每个 IP 每天 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 进行正常运行时间监控。