newsletter-commerce-mcp

新闻通讯电商情报 MCP

将新闻通讯转化为联盟营销收入。 从任意 Substack、Ghost 或 Beehiiv 期刊中提取赞助产品、品牌提及和联盟营销信号。随后自动生成可直接粘贴到新闻通讯中的「本期产品」可购物版块。评测套件 F1=100%。免费档：每天 200 次调用。

⭐ 如果这个项目为你节省了时间，请给仓库点个星标 — 这有助于其他开发者找到它。

在线端点：https://newsletter-commerce-mcp.sincetoday.workers.dev/mcp · 查看示例

从新闻通讯中提取产品提及、评估赞助商，并追踪联盟营销趋势。支持 Substack、Ghost、Beehiiv 和纯文本。基于 x402 构建；x402 是由 Shopify、Google、Microsoft、Visa 和 Linux Foundation 支持的开放支付标准。

工具

工具	描述
extract_newsletter_products	从新闻通讯期刊中提取产品、联盟链接和赞助商提及
analyze_newsletter_sponsors	根据 CPM、读完率和受众契合度为赞助版块评分
track_product_trends	比较多个新闻通讯期刊中的产品提及，以发现热门产品和品牌模式
generate_newsletter_products_section	将提取的产品整理为「本期产品」页脚版块（Markdown 或 HTML）

快速开始

# Install
npm install newsletter-commerce-mcp

# Configure
cp .env.example .env
# Edit .env: set OPENAI_API_KEY

# Run (stdio MCP server)
npx newsletter-commerce-mcp

MCP 客户端配置

{
  "mcpServers": {
    "newsletter-commerce": {
      "command": "npx",
      "args": ["newsletter-commerce-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

工具参考

extract_newsletter_products

{
  "content": "Newsletter HTML or plain text (max 200k chars)",
  "newsletter_id": "optional-cache-key",
  "format": "html",
  "api_key": "optional-paid-key"
}

返回：

{
  "newsletter_id": "swipe-file-issue-47",
  "products": [
    {
      "name": "Notion AI",
      "category": "saas",
      "mention_context": "running my entire writing workflow through Notion AI",
      "recommendation_strength": "strong",
      "affiliate_link": null,
      "confidence": 0.94,
      "is_sponsored": false
    }
  ],
  "sponsor_sections": [...],
  "_meta": { "processing_time_ms": 1620, "ai_cost_usd": 0.0028, "cache_hit": false }
}

analyze_newsletter_sponsors

{
  "content": "Newsletter HTML or plain text",
  "newsletter_id": "optional",
  "api_key": "optional"
}

返回每个赞助版块的 CPM 估算值、读完率和赞助商与读者的契合度评分。

track_product_trends

{
  "newsletter_ids": ["issue-45", "issue-46", "issue-47"],
  "category_filter": ["saas", "books"]
}

需要先对每个 newsletter_id 调用 extract_newsletter_products。返回趋势数据，包括每种产品趋势的 top_category、avg_recommendation_strength 和 brand。

generate_newsletter_products_section

{
  "newsletter_id": "swipe-file-issue-47",
  "format": "markdown",
  "style": "full",
  "api_key": "optional"
}

将提取的产品整理为可直接粘贴的「本期产品」版块。传入 newsletter_id（使用缓存的提取结果）或直接传入 products[]。format：markdown（默认）或 html。style：full（默认，按推荐强度分组并附上上下文引文）或 minimal（精简列表）。

输出示例

从一份 TLDR Tech 新闻通讯中实时提取（实时评测：F1=88%，得分 95/100，每次调用 $0.00051，耗时 7390ms）：

{
  "newsletter_id": "tldr-2024-03-07",
  "products": [
    {
      "name": "Groq",
      "category": "saas",
      "mention_context": "Groq has launched public API access — runs Llama 2 at 300 tokens/second",
      "confidence": 0.94,
      "recommendation_strength": "neutral"
    },
    {
      "name": "Devin (Cognition AI)",
      "category": "saas",
      "mention_context": "first AI software engineer — benchmarks show it can complete real GitHub issues end-to-end",
      "confidence": 0.91,
      "recommendation_strength": "strong"
    }
  ]
}

完整输出及价值说明请参见 /examples 端点：https://newsletter-commerce-mcp.sincetoday.workers.dev/examples

定价

• 免费档：每个 Agent 每天 200 次调用（无需 API 密钥）
• 付费：$0.01/次调用 — 使用有效密钥设置 MCP_API_KEYS

环境变量

变量	必填	默认值	描述
OPENAI_API_KEY	是	—	OpenAI API 密钥
AGENT_ID	否	anonymous	用于速率限制的 Agent 标识符
MCP_API_KEYS	否	—	以逗号分隔的付费 API 密钥
CACHE_DIR	否	./data/cache.db	SQLite 缓存路径
PAYMENT_ENABLED	否	false	设置为 true 以强制执行限制

开发

npm install
npm run typecheck   # Zero type errors
npm test            # All tests pass
npm run build       # Compile to dist/

许可证

MIT — Since Today Studio