daiso-mcp

<div align="center"> <img src="./assets/logo.svg" alt="Daiso MCP" width="120" height="120"> <br> <br> # Tool List Daiso (products/stores/inventory), Lotte Mart (stores/products), GS25 (stores/products/inventory), 7-Eleven (products/stores/inventory/popular search terms/catalog), CU (stores/inventory), Emart24 (stores/products/inventory), Olive Young (stores/inventory), Megabox (theaters/movies/schedules/seats), Lotte Cinema (theaters/movies/seats), CGV (theaters/movies/schedules) query functions are connected to AI. <br> [](https://opensource.org/licenses/MIT) [](https://workers.cloudflare.com/) [](https://modelcontextprotocol.io/) [](https://github.com/hmmhmmhm/daiso-mcp/actions/workflows/coverage.yml) [](https://github.com/hmmhmmhm/daiso-mcp/actions/workflows/coverage.yml) <!-- WORKERS_INVOCATIONS_CHART:START --> <h3>Cloudflare Workers Invocations (2026-03-01 ~ 2026-04-29, 60 days)</h3> <img src="./assets/analytics/workers-invocations.png?v=2026-04-29T16:03:14.653Z" alt="Cloudflare Workers Invocations Graph (2026-03-01 ~ 2026-04-29)" width="100%"> _{Worker: <code>daiso-mcp</code> · Last update: 2026-04-30 01:03 KST} <!-- WORKERS_INVOCATIONS_CHART:END --> <br> <br> <img src="https://i.imgur.com/mPwS4Kv.png" width="400">&nbsp;&nbsp;<img src="https://i.imgur.com/MrndJ3g.png" width="400"> </div> <br> --- <br> ## Connecting MCP to AI Apps You can connect and use it directly with AI apps like ChatGPT, Claude, and Grok. Please follow the app-specific guides below to integrate and then request searches/inventory/movie queries. <br> ###  > Feedback has been received that MCP integration is difficult, so a GPT app that can be used immediately has been added. > You can use it easily on mobile by clicking the link below! **[Daiso MCP GPT App Direct Link](https://chatgpt.com/g/g-69a5266c32108191b71a24642dc63f9e-daiso-mcp)** Quick usage examples: ``` Tell me about storage box using Daiso MCP Tell me about Olive Young store near Myeong-dong using Olive Young MCP Tell me about Emart24 store near Gangnam and inventory of Dubai using Emart24 MCP Tell me about Lotte Mart store near Jamsil using Lotte Mart MCP Tell me about inventory of cola at Gangbyeon branch of Lotte Mart using Lotte Mart MCP Tell me about GS25 store near Gangnam and inventory of sweet potato fries using GS25 MCP Tell me about 7-Eleven product "samgyetang" using 7-Eleven MCP Tell me about 7-Eleven store near Ansan Central Station using 7-Eleven MCP Tell me about inventory of hot dog at 7-Eleven near Ansan Central Station using 7-Eleven MCP Tell me about popular search terms and catalog summary of 7-Eleven using 7-Eleven MCP Tell me about movie and remaining seats at Gangnam branch of Megabox using Megabox MCP Tell me about Lotte Cinema branch near World Tower and movies being shown using Lotte Cinema MCP Tell me about remaining seats at World Tower branch of Lotte Cinema using Lotte Cinema MCP Tell me about movies and schedules at Gangnam CGV using CGV MCP ``` <br> ###  > Pro / Max / Team / Enterprise plan required · Can be used on mobile app when set up on web 1. Go to **Settings** → **Connectors** on [claude.ai](https://claude.ai) 2. Click **Add custom connector** 3. Enter remote MCP server URL: `https://mcp.aka.page` 4. Click **Add** to complete 5. Activate by clicking **+** button → **Connectors** → toggle Usage examples: ``` Use Daiso MCP to search for storage box Use Daiso MCP to find stores near Gangnam Station Use Olive Young MCP to find stores near Myeong-dong Use Olive Young MCP to check inventory of sunscreen Use Emart24 MCP to find stores near Gangnam and check inventory of Dubai Use Lotte Mart MCP to find stores near Jamsil Use Lotte Mart MCP to check inventory of cola at Gangbyeon branch Use GS25 MCP to find stores near Gangnam and check inventory of sweet potato fries Use 7-Eleven MCP to find stores near Ansan Central Station and check inventory of hot dog Use Megabox MCP to find branches near Gangnam Station Use Megabox MCP to check movie list and remaining seats at Gangnam branch Use Lotte Cinema MCP to find branches near Jamsil Use Lotte Cinema MCP to check movie list and remaining seats at World Tower Use CGV MCP to find movie theaters in Seoul Use CGV MCP to check movies and schedules at Gangnam CGV ``` Reference: [Claude Remote MCP Guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) <br> ###  > Add MCP server to Claude Code CLI ```bash claude mcp add daiso-mcp https://mcp.aka.page --transport sse ``` <br> ###  > Supports both web and mobile apps **Prompt page URL:** ``` https://mcp.aka.page/prompt ``` Usage: 1. Ask the agent to read the page at `https://mcp.aka.page/prompt` on Grok mobile app 2. The agent understands the API usage and executes the function with a GET request Example conversation: ``` User: Read https://mcp.aka.page/prompt AI: (Reads the page and understands API usage) User: Search for storage box AI: (Calls https://mcp.aka.page/api/daiso/products?q=storage box and provides results) User: Find Megabox branch near Ansan Central Station AI: (Calls https://mcp.aka.page/api/megabox/theaters?keyword=Ansan%20Central%20Station and provides results) User: Find Lotte Cinema branch near Jamsil AI: (Calls https://mcp.aka.page/api/lottecinema/theaters?keyword=%EC%9E%A0%EC%8B%A4 and provides results) User: Check CGV schedule at Gangnam AI: (Calls https://mcp.aka.page/api/cgv/timetable?playDate=20260304&theaterCode=0056 and provides results) User: Find CGV near Ansan Central Station and check today's movies and schedules AI: (Calls https://mcp.aka.page/api/cgv/theaters?playDate=20260315&keyword=Ansan%20Central%20Station and provides results) AI: (Calls https://mcp.aka.page/api/cgv/movies?playDate=20260315&keyword=Ansan%20Central%20Station and provides results) AI: (Calls https://mcp.aka.page/api/cgv/timetable?playDate=20260315&keyword=Ansan%20Central%20Station and provides results) ``` <br> ### MCP Server URL / CLI (Advanced) Reference only when directly connecting or using in scripts instead of AI apps. MCP server URL: ``` https://mcp.aka.page ``` CLI (npx): ```bash # Interactive mode (recommended) npx daiso # Non-interactive mode (CI/scripts) npx daiso --non-interactive # Command-line mode npx daiso help npx daiso help products npx daiso url npx daiso health npx daiso claude # Direct queries without AI npx daiso products storage box npx daiso product 1034604 npx daiso stores Gangnam Station npx daiso inventory 1034604 --keyword Gangnam Station npx daiso display-location 1034604 04515 npx daiso cu-stores Gangnam npx daiso cu-inventory snacks --storeKeyword Gangnam npx daiso lottemart-stores Jamsil --area Seoul --limit 10 npx daiso lottemart-products cola --storeName Gangbyeon --area Seoul npx daiso emart24-stores Gangnam --service24h true npx daiso emart24-products Dubai --pageSize 20 npx daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015 npx daiso gs25-stores Gangnam --limit 10 npx daiso gs25-products sweet potato fries --limit 20 npx daiso gs25-inventory sweet potato fries --storeKeyword Gangnam --storeLimit 10 npx daiso seveneleven-products samgyetang --size 20 npx daiso seveneleven-stores Ansan Central Station --limit 10 npx daiso get /api/seveneleven/inventory --keyword hot dog --storeKeyword Ansan%20Central%20Station --storeLimit 10 npx daiso seveneleven-popwords --label home npx daiso seveneleven-catalog --includeIssues true --includeExhibition true --limit 10 npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056 # Original JSON needed npx daiso products storage box --json ``` ### OpenAPI Specification - OpenAI Chatbot Registration Abbreviated Spec: `https://mcp.aka.page/openapi.json` - OpenAI Chatbot Registration YAML: `https://mcp.aka.page/openapi.yaml` - Full Individual Endpoint Spec (JSON): `https://mcp.aka.page/openapi-full.json` - Full Individual Endpoint Spec (YAML): `https://mcp.aka.page/openapi-full.yaml` The default `openapi.json` exposes only a single facade, `GET /api/actions/query`, to comply with OpenAI Actions import limitations. Existing service-specific GET APIs are maintained; detailed background information can be found in the [OpenAPI Actions Facade documentation](./docs/openapi-actions-facade.md). Interactive Example: ```text $ npx daiso Daiso Interactive Mode [Service Selection] 1. Daiso 2. Olive Young 3. CU Please select a service number (0: Exit): 1 Enter a store search keyword: Gangnam [Store Selection] 1. Daiso Gangnam Branch | Seoul Gangnam-gu ... 2. Daiso Gangnam Station Branch | Seoul Gangnam-gu ... Input: Select a number | /keyword filter | all Show All | 0 Search Again Selection: /station branch Selection: 1 [Selected Store Information] - Store Name: Daiso Gangnam Station Branch - Address: Seoul Gangnam-gu ... - Phone: 02-... Enter a product keyword: Storage Box [Product Selection] 1. Handle Storage Box (2000 KRW, ID: 1034604) 2. Foldable Storage Box (3000 KRW, ID: 1034605) Input: Select a number | /keyword filter | all Show All | 0 Cancel Selection: 1 [Inventory Result] - Product: Handle Storage Box - Store: Daiso Gangnam Station Branch - Inventory Quantity: 7 [Next Action] 1. Find another product at the same store 2. Re-select store/service 3. Exit Please select a number: 3 Interactive mode exited. ``` <br> ### Unsupported Services | Service | Status | | :---------------------------------------------------------------------------------------------------- | :-------- | |  Google Gemini | ❌ Not Supported | |  GitHub Copilot | ❌ Not Supported | <br> ## Special Thanks We would like to extend our gratitude to those who have contributed to this project. - [@thecats1105](https://github.com/thecats1105): Implemented Daiso display location query tool (`daiso_get_display_location`) and API/test integration - [@betterthanhajin](https://github.com/betterthanhajin): Implemented CGV service provider (theater/movie/schedule tool, route specification and test addition) - [Zerocho](https://youtube.com/shorts/ZgIqA1NCEp0?si=UW0pKsSpqmEi7lXG): Assisted with project promotion <br> --- <br> ## Detailed Documentation Detailed explanations that were previously included have been moved to separate documents. - [Service Reference](./docs/service-reference.md) - [CONTRIBUTING Guide](./CONTRIBUTING.md) <br> --- <br> ## Documentation ### General Guides - [Service Reference](./docs/service-reference.md) - [Scraping Playbook](./docs/scraping-playbook.md) - [mitmproxy Guide](./docs/mitmproxy-guide.md) - [AI Instructions](./docs/ai-instruction.md) ### Daiso - [Daiso Network Analysis Result](./docs/daiso-network-analysis-result.md) - [Daiso Playwright Network Analysis](./docs/daiso-playwright-network-analysis.md) - [Daiso Replay Session Test HTML](./docs/daiso-replay-session-test.html) - [Daiso Test Replay Script](./docs/daiso-test-replay.ts) ### CU - [CU Network Analysis Result](./docs/cu-network-analysis-result.md) - [CU App Request Capture Guide](./docs/cu-app-request-capture-guide.md) - [CU App Scraping Replay Guide](./docs/cu-app-scraping-replay-guide.md) ### Emart24 - [Emart24 Network Analysis Result](./docs/emart24-network-analysis-result.md) - [Emart24 App Scraping Preparation Guide](./docs/emart24-app-scraping-preparation-guide.md) - [Emart24 App Scraping Replay Guide](./docs/emart24-app-scraping-replay-guide.md) ### Lotte Mart - [Lotte Mart Mobile Help Center Scraping Replay Plan](./docs/lottemart-mobile-scraping-replay-plan.md) ### General - [OpenAPI Actions Facade Refactoring Background](./docs/openapi-actions-facade.md) ### Olive Young - [Olive Young Network Analysis Result](./docs/oliveyoung-network-analysis-result.md) - [Olive Young Playwright MCP Onboarding](./docs/oliveyoung-playwright-mcp-onboarding.md) - [Olive Young Playwright Network Analysis](./docs/oliveyoung-playwright-network-analysis.md) - [Olive Young Lightpanda Validation](./docs/oliveyoung-lightpanda-validation.md) - [Olive Young Replay Session Test Script](./docs/oliveyoung-replay-session-test.ts) - [Olive Young Zyte Bandwidth Test](./docs/oliveyoung-zyte-bandwidth-test.ts) - [Olive Young Zyte Replay Test](./docs/oliveyoung-zyte-replay-test.ts) ### Movie Theaters - [CGV Network Analysis Result](./docs/cgv-network-analysis-result.md) - [Megabox Network Analysis Result](./docs/megabox-network-analysis-result.md) - [Lotte Cinema Network Analysis Result](./docs/lottecinema-network-analysis-result.md) ### GS25 - [GS25 API Replay Methodology (Final)](./docs/gs25-final-replay-methodology.md) - [GS25 Network Analysis Result (Archive)](./docs/archive/gs25-network-analysis-result.md) - [GS25 Android Bypass Capture Guide (Archive)](./docs/archive/gs25-android-bypass-capture-guide.md) - [GS25 App Capture Attempt Log (2026-03-08, Archive)](./docs/archive/gs25-app-capture-attempt-log-20260308.md) - [GS25 App Scraping Preparation Guide (Archive)](./docs/archive/gs25-app-scraping-preparation-guide.md) - [GS25 Session Handover Document (2026-03-09, Archive)](./docs/archive/gs25-session-handoff-20260309.md) <br> --- <div align="center"> <br> MIT License <br> </div> --- ## Guidelines for Adding New MCP Features When adding new services or tools, ensure that implementation is not the only focus; also verify the following: - `MCP`: Register services in `src/index.ts`, root service/tool list, and related tests - `HTTPS`: GET API handler/route, prompt page (`src/pages/prompt.ts`), and app integration tests - `CLI`: `src/cli.ts`, `src/cliHelp.ts`, and CLI tests - `AI Instruction`: [ai-instruction.md](./docs/ai-instruction.md) usage rules and workflow - `README`: Supported service descriptions, examples, and documentation links - `OpenAPI`: Basic `/openapi.json` facade specification, `/openapi-full.json` full specification, and related tests Minimum verification criteria after feature addition: - `npm run typecheck` - `npm test`