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에게 중요한 이유 – 데이터는 많은 LLM 기반 에이전트(Claude, ChatGPT, Home Assistant, Grok 등)가 기본적으로 이해하는 MCP 표준으로 패키징됩니다. 이를 통해 대화형 모델은 “다이소 mcp로 수납박스 검색해줘” 같은 질문을 하고 제품 이름, 가격, 매장 위치, 재고 수준을 포함한 바로 사용 가능한 JSON 응답을 받을 수 있습니다. 사용자 지정 스크래핑이나 자격 증명 처리가 필요 없습니다.

핵심 기능

카테고리	서비스(출처)	주요 쿼리
장소	네이버 지역 검색	주변 음식점, 카페, 디저트, 기타 관심 지점
교통	오피넷(유가 네트워크)	전국 평균 연료 가격, 가장 저렴한 주유소, 주유소별 세부 정보
소매 비교	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당 하루 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
웹 검색 – 공개 프론트 페이지 작동 방식: 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을 통한 가동 시간 모니터링.