newsletter-commerce-mcp

ニュースレターコマースインテリジェンス MCP

ニュースレターをアフィリエイト収益につなげましょう。 Substack、Ghost、Beehiiv のあらゆる記事から、スポンサー商品、ブランドへの言及、アフィリエイトのシグナルを抽出します。その後、ニュースレターにそのまま貼り付けられる、ショッピング可能な「この号の商品」セクションを自動生成します。評価スイートで F1=100％を達成。無料プランでは 1 日あたり 200 回利用できます。

⭐ 時間の節約に役立ったら、リポジトリにスターを付けてください — ほかの開発者にも見つけてもらいやすくなります。

ライブエンドポイント：https://newsletter-commerce-mcp.sincetoday.workers.dev/mcp · サンプルを見る

ニュースレターから商品への言及を抽出し、スポンサーを評価して、アフィリエイトのトレンドを追跡します。Substack、Ghost、Beehiiv、プレーンテキストに対応しています。Shopify、Google、Microsoft、Visa、Linux Foundation が支援するオープンな決済標準、x402 を基盤としています。

ツール

ツール	説明
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、1 回あたり $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

料金

• 無料プラン：エージェントごとに 1 日あたり 200 回（API キー不要）
• 有料：1 回あたり $0.01 — 有効なキーを MCP_API_KEYS に設定してください

環境変数

変数	必須	デフォルト	説明
OPENAI_API_KEY	はい	—	OpenAI API キー
AGENT_ID	いいえ	anonymous	レート制限に使用するエージェント識別子
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