Skip to content

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

daiso-utils

ダイソーの商品検索、店舗検索、在庫確認を行う非公式ツールです。CLI と MCP サーバーは同じ Web API に接続します。

セットアップ

Node.js 24.22 以降の 24 系と npm を使います。

npm install
npm run dev:api

API は http://localhost:8787 で起動します。Cloudflare Workers へのデプロイは npm run deploy:api で実行します。複数の Cloudflare アカウントを利用している場合は、環境変数 CLOUDFLARE_ACCOUNT_ID にデプロイ先のアカウント ID を指定してください。

CLI

node packages/cli/src/cli.js search 収納ケース
node packages/cli/src/cli.js product 4550000000000
node packages/cli/src/cli.js stores 渋谷
node packages/cli/src/cli.js stock 4550000000000 001
node packages/cli/src/cli.js health --json

接続先は --api-url <url> または環境変数 DAISO_API_URL で指定できます。両方指定した場合は --api-url が優先されます。--json を付けると API のレスポンスをそのまま出力します。

Web API

メソッドとパス 内容 パラメーター
GET / API の名前とバージョン
GET /health 稼働状況
GET /v1/products 商品検索 q に検索語
GET /v1/products/:jan 商品照会 jan に JAN コード
GET /v1/stores 店舗検索 area に地域名
GET /v1/inventory 在庫確認 jan に JAN コード、storeId に店舗 ID

JAN コードには 8 桁または 13 桁の数字を指定します。検索結果が 0 件の場合は 200 と空の items を返します。入力に不備がある場合は 400、照会先が見つからない場合は 404 を返します。

curl http://localhost:8787/health

MCP

ローカルで起動する stdio サーバーです。MCP クライアントの設定例のパスを、クローン先の絶対パスに置き換えてください。

{
  "mcpServers": {
    "daiso": {
      "command": "node",
      "args": ["/path/to/daiso-utils/packages/mcp/src/index.js"],
      "env": { "DAISO_API_URL": "http://localhost:8787" }
    }
  }
}

利用できるツールは search_products、get_product、search_stores、check_stock、check_health です。

npm パッケージ

npm pack -w daiso-cli --dry-run で、公開するファイルを確認できます。公開したパッケージは npx daiso-cli または npm install -g daiso-cli で実行できます。