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：设置 → 连接器 → 添加自定义连接器 → https://dealsping-ai.akhilbabumfwa.workers.dev/mcp

关于 DealsPing

DealsPing（dealsping.in）汇总 Amazon、Flipkart、Myntra、Ajio 及其他印度电商商店的最佳优惠。

作为 Amazon Associate，DealsPing 会从符合条件的购买中赚取佣金。

---

架构

基于 Cloudflare Workers + D1 的后端，将 DealsPing 的 Firebase 优惠数据镜像到快速、可供 AI 查询的 API、MCP 服务和管理仪表板。与 dealsping-next 完全独立——仅从 Firebase 读取，不会写回。

• sync.js — 从 Firestore REST API 拉取 deals + monitored_deals（不使用 SDK），映射到 D1 架构，执行 upsert，并将过期优惠标记为不活跃。
• 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 — 路由器 + 定时任务处理器（每 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 isolate 中以内存实现——并非严格分布式。足以遏制一般滥用；如需严格保证，请迁移到 Durable Objects 或基于 KV 的计数器。
• Affiliate URLs 从 Firebase 原样复制——绝不修改。
• 同步过程不会访问 Firebase；它通过 Firestore REST API 和 API key 以只读方式进行。
• 源项目中的 firestore.rules 已为 deals/monitored_deals 设置 allow read: if true，因此仅读取时仅需 API key（无需服务账号）。
• ASIN 目录（asin_catalog 表，为 check_and_link/search_catalog 提供支持）有意不存储价格/图片/可用性数据——原因请参阅 check_and_link 的工具说明。

许可证

MIT

联系方式

[email protected]