DealsPing — India Deals

DealsPing MCP サーバー

インドのAI搭載お得情報検索プラットフォームです。Claudeやその他のAIプラットフォームから、Amazon、Flipkartをはじめとするインドのストアで最もお得な情報を見つけられます。

MCP サーバー URL

https://dealsping-ai.akhilbabumfwa.workers.dev/mcp

トランスポート：Streamable HTTP（POST経由のJSON-RPC 2.0、GET経由のオプションのSSEストリーム）。

利用可能なツール

ツール	説明
search_deals	キーワードでお得情報を検索
get_best_deals	スコア上位のお得情報を取得
get_latest_deals	最新のお得情報を取得
get_trending_deals	トレンドのお得情報を取得
get_deals_by_category	カテゴリで絞り込み
get_deals_by_price	価格帯で絞り込み
get_deals_by_store	ストアで絞り込み
get_deal	特定のお得情報の詳細を取得
get_categories	すべてのカテゴリを一覧表示
check_and_link	商品を確認してアフィリエイトリンクを取得
bulk_check_and_link	複数の商品を確認
search_catalog	商品カタログを検索

使い方

Claudeに追加するには、Settings → Connectors → Add custom connector → https://dealsping-ai.akhilbabumfwa.workers.dev/mcp

DealsPingについて

DealsPing（dealsping.in）は、Amazon、Flipkart、Myntra、AjioをはじめとするインドのECストアから、最もお得な情報を集約しています。

Amazonアソシエイトとして、DealsPingは適格販売から収益を得ています。

---

アーキテクチャ

Cloudflare Workers + D1バックエンドにより、DealsPingのFirebaseのお得情報データをミラーリングし、高速でAIから検索できるAPI、MCPサーバー、管理ダッシュボードを提供します。dealsping-nextとは完全に独立しており、Firebaseに対する読み取り専用で、書き戻しは行いません。

• sync.js — Firestore REST APIからdeals + monitored_dealsを取得し（SDKは使用しません）、D1スキーマにマッピングしてアップサートし、古くなったお得情報を非アクティブにします。
• engine.js — お得情報のスコア（0～100）計算、鮮度の減衰、AIリストの再構築、4日ごとのカテゴリローテーションを行います。
• api.js — パブリックREST API（/api/*）。レート制限付き、CORSはオープン、キャッシュヘッダーの有効期間は5分です。
• mcp.js — /mcpのMCPサーバー（Streamable HTTP：JSON-RPC 2.0のハンドシェイク、tools/list、tools/call）。
• admin.js — 保護されたダッシュボードAPI（/admin/*）。X-Admin-Secretヘッダーでアクセスを制限します。
• index.js — ルーター + cronハンドラー（6時間ごとに同期、2日ごとにリストを再構築、4日ごとにカテゴリをローテーション）。

セットアップ

npm install

# 1. Create the D1 database
npx wrangler d1 create dealsping-ai-db
# → copy the returned database_id into wrangler.toml

# 2. Apply schema (local + remote)
npx wrangler d1 execute dealsping-ai-db --file=schema.sql
npx wrangler d1 execute dealsping-ai-db --file=schema.sql --remote

# 3. Set secrets
npx wrangler secret put FIREBASE_API_KEY   # your Firebase Web API key
npx wrangler secret put SYNC_SECRET        # random string
npx wrangler secret put ADMIN_SECRET       # random string

# 4. Deploy
npx wrangler deploy

エンドポイント

パス	用途
GET /health	ヘルスチェック
GET /api/deals/best	スコア順のお得情報上位
GET /api/deals/latest	最新のお得情報
GET /api/deals/trending	トレンドのお得情報
GET /api/deals/featured	注目のお得情報
GET /api/deals/search?q=	キーワード検索
GET /api/deals/category/:category	カテゴリ別のお得情報
GET /api/deals/price?min=&max=	価格帯別のお得情報
GET /api/deals/store/:store	ストア別のお得情報
GET /api/deals/:id	単一のお得情報（idまたはslug）
GET /api/lists/:list_type	任意のAIリスト
GET /api/categories	カテゴリ別件数
GET /api/catalog/stats	ASINカタログの統計
GET /api/stats	プラットフォームの統計
GET/POST/DELETE /mcp	MCPサーバー（Streamable HTTP）
GET /.well-known/mcp.json	軽量なディスカバリーマニフェスト
GET /.well-known/ai-plugin.json	ChatGPTプラグインマニフェスト
GET /openapi.yaml	OpenAPI 3.0仕様
GET /dashboard	管理ダッシュボードUI
GET/POST /admin/*	管理API（X-Admin-Secretが必要）
POST /sync	手動同期のトリガー（X-Sync-Secretが必要）

AIリスト

best_deals、latest_deals、trending_deals、featured_deals、under_500、under_1000、under_2000、under_5000、electronics、fashion、home_kitchen、mobiles、with_coupon、with_bank_offer、amazon_deals、flipkart_deals。

お得情報スコアの計算式（0～100）

discount_score   = (discount_pct / 100) * 25
freshness_score  = freshness (0-1, decays over 7 days) * 20
price_score      = tiered by current_price, max 15
trending_score   = 15 if trending else 0
featured_score   = 10 if featured else 0
coupon_bonus     = 10 if coupon_code else 0
bank_offer_bonus = 5 if bank_offer else 0

注意事項／制限事項

• レート制限（60 req/min/IP）は、Worker の分離環境ごとにインメモリでベストエフォートとして適用されます。厳密に分散された制限ではありません。一般的な不正利用を抑えるには十分ですが、確実な保証が必要な場合は、Durable Objects または KV を利用したカウンターに移行してください。
• アフィリエイト URL は Firebase からそのままコピーされ、変更されることはありません。
• 同期処理が Firebase にアクセスすることはありません。API キーを使った Firestore REST API 経由の読み取り専用です。
• ソースプロジェクトの firestore.rules では、deals／monitored_deals に対してすでに allow read: if true が設定されているため、読み取りにサービスアカウントは不要で、API キーだけで十分です。
• ASIN カタログ（check_and_link／search_catalog が使用する asin_catalog テーブル）には、意図的に価格／画像／在庫状況のデータを保存していません。理由については、check_and_link のツールの説明をご覧ください。

ライセンス

MIT

お問い合わせ

[email protected]