daiso-mcp

<div align="center"> <img src="./assets/logo.svg" alt="Daiso MCP" width="120" height="120"> <br> <br> # Tool List Connects 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) inquiry functions 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 Invocation Count (2026-03-01 ~ 2026-03-30, 30 days)</h3> <img src="./assets/analytics/workers-invocations.png?v=2026-03-30T15:49:38.161Z" alt="Cloudflare Workers Invocation Count Graph (2026-03-01 ~ 2026-03-30)" width="100%"> _{Worker: <code>daiso-mcp</code> · Last updated: 2026-03-31 00:49 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> ## Connect MCP to AI Apps You can connect and use it directly with AI apps like ChatGPT, Claude, and Grok. <br> ### ** Quick usage examples: ``` Search for storage boxes using daiso mcp Find Olive Young store near Myeong-dong using oliveyoung mcp Find Emart24 store near Gangnam and check Dubai inventory using emart24 mcp Find Lotte Mart store near Jamsil using lottemart mcp Check cola inventory at Gangbyeon Lotte Mart using lottemart mcp Find GS25 store near Gangnam and check Oh Gamja inventory using gs25 mcp Search for triangle-shaped rice balls using seveneleven mcp Find 7-Eleven store near Ansan Central Station using seveneleven mcp Check Hotdog inventory at 7-Eleven near Ansan Central Station using seveneleven mcp Check popular search terms and catalog summary using seveneleven mcp Find Megabox theater and remaining seats near Gangnam using megabox mcp Find Lotte Cinema theater and movies near World Tower using lottecinema mcp Check remaining seats at World Tower Lotte Cinema using lottecinema mcp Check movie schedules and times at Gangnam CGV using cgv mcp ``` <br> ###  > Requires Pro / Max / Team / Enterprise plan · Can be used on mobile apps when set up on the web 1. Go to **Settings** → **Connectors** on [claude.ai](https://claude.ai) 2. Click **Add custom connector** 3. Enter the remote MCP server URL: `https://mcp.aka.page` 4. Click **Add** to complete 5. Activate by clicking the **+** button → **Connectors** → toggle switch Usage examples: ``` Use daiso mcp to search for storage boxes Use daiso mcp to find stores near Gangnam Station Use oliveyoung mcp to find stores near Myeong-dong Use oliveyoung mcp to check sunscreen inventory Use emart24 mcp to find stores near Gangnam and check Dubai inventory Use lottemart mcp to find stores near Jamsil Use lottemart mcp to check cola inventory at Gangbyeon Lotte Mart Use gs25 mcp to find stores near Gangnam and check Oh Gamja inventory Use seveneleven mcp to find stores near Ansan Central Station and check Hotdog inventory ``` 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 Grok mobile app to read the page at `https://mcp.aka.page/prompt` 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 boxes AI: (Calls https://mcp.aka.page/api/daiso/products?q=storage%20boxes and provides results) User: Find Megabox theater near Ansan Central Station AI: (Calls https://mcp.aka.page/api/megabox/theaters?keyword=Ansan%20Central%20Station and provides results) User: Find Lotte Cinema theater near Jamsil AI: (Calls https://mcp.aka.page/api/lottecinema/theaters?keyword=%EC%9E%A0%EC%8B%A4 and provides results) User: Check movie schedules at Gangnam CGV AI: (Calls https://mcp.aka.page/api/cgv/timetable?playDate=20260304&theaterCode=0056 and provides results) User: Find CGV near Ansan Central Station and show 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 for direct connection or usage in scripts. 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 inquiry without AI npx daiso products storage%20boxes npx daiso product 1034604 npx daiso stores Gangnam%20Station npx daiso inventory 1034604 --keyword Gangnam%20Station 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%20Point --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 Oh%20Gamja --limit 20 npx daiso gs25-inventory Oh%20Gamja --storeKeyword Gangnam --storeLimit 10 npx daiso seveneleven-products triangle%20rice%20balls --size 20 npx daiso seveneleven-stores Ansan%20Central%20Station --limit 10 npx daiso get /api/seveneleven/inventory --keyword Hotdog --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%20boxes --json ``` ### OpenAPI Spec - 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` only exposes a single facade, `GET /api/actions/query`, to comply with OpenAI Actions import limitations. Existing service-specific GET APIs are maintained, and detailed background information can be found in the [OpenAPI Actions Facade document](./docs/openapi-actions-facade.md). Interactive example: ```text $ npx daiso daiso interactive mode [Select Service] 1. Daiso 2. Olive Young 3. CU Please select a service number (0: exit): 1 Enter a store search keyword: 강남 [Select Store] 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 search 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 in the same store 2. Re-select a different 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 thank the following individuals for their contributions to this project. - [@thecats1105](https://github.com/thecats1105): Implementation of the Daiso display location query tool (`daiso_get_display_location`) and API/test integration - [@betterthanhajin](https://github.com/betterthanhajin): Implementation of the CGV service provider (theater/movie/time table tools, route specification and testing) - [제로초님](https://youtube.com/shorts/ZgIqA1NCEp0?si=UW0pKsSpqmEi7lXG): Project promotion assistance <br> --- <br> ## Detailed Documents The detailed explanations that were previously here have been moved to separate documents. - [Service Reference](./docs/service-reference.md) - [CONTRIBUTING Guide](./CONTRIBUTING.md) <br> --- <br> ## docs Documents ### Common 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) ### Common - [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> --- ## Precautions for Adding New MCP Features When adding new services or tools, ensure that you not only implement them but also verify the following: - `MCP`: Register the service in `src/index.ts`, update the root service/tool list, and include relevant tests. - `HTTPS`: Implement GET API handlers/routes, update the prompt page (`src/pages/prompt.ts`), and include app integration tests. - `CLI`: Update `src/cli.ts`, `src/cliHelp.ts`, and include CLI tests. - `AI instruction`: Reflect usage rules and workflows in [ai-instruction.md](./docs/ai-instruction.md). - `README`: Update service descriptions, examples, and documentation links. - `OpenAPI`: Update the basic `/openapi.json` facade spec, `/openapi-full.json` full spec, and include relevant tests. Minimum verification criteria after feature addition: - `npm run typecheck` - `npm test`