{"mcp":"newsletter-commerce-mcp","version":"0.1.0","examples":[{"tool":"extract_newsletter_products","description":"Extract product mentions, recommendations, and affiliate links from a newsletter. Supports HTML (Substack, Ghost, Beehiiv) and plain text. Returns product name, category, recommendation_strength, affiliate_link, brand (null for generics), aestheticTags (warmth/density/origin/tradition), and is_sponsored flag per product.","input":{"content":"**This week's tools** — I've been running my entire writing workflow through Notion AI for three months now. Genuinely the best $10/month I spend... [SPONSOR] Today's issue is brought to you by Beehiiv — the newsletter platform built for growth. Start free at beehiiv.com/growth... Back to tools: I finally switched to Linear for project management. No affiliate link, just a real recommendation. The Kanban view alone is worth it...","newsletter_id":"swipe-file-issue-47","format":"markdown"},"output":{"newsletter_id":"swipe-file-issue-47","products":[{"name":"Notion AI","category":"saas","mention_context":"running my entire writing workflow through Notion AI for three months now. Genuinely the best $10/month","recommendation_strength":"strong","affiliate_link":null,"confidence":0.94,"is_sponsored":false},{"name":"Beehiiv","category":"saas","mention_context":"newsletter platform built for growth. Start free at beehiiv.com/growth","recommendation_strength":"endorsed","affiliate_link":"beehiiv.com/growth","confidence":0.99,"is_sponsored":true},{"name":"Linear","category":"saas","mention_context":"switched to Linear for project management. No affiliate link, just a real recommendation. The Kanban view alone is worth it","recommendation_strength":"strong","affiliate_link":null,"confidence":0.96,"is_sponsored":false}],"sponsor_sections":[{"sponsor_name":"Beehiiv","section_context":"Today's issue is brought to you by Beehiiv","estimated_cpm_usd":35,"estimated_read_through":0.61,"call_to_action":"beehiiv.com/growth","sponsor_fit_score":0.88}],"_meta":{"processing_time_ms":1620,"ai_cost_usd":0.0028,"cache_hit":false}},"value_narrative":"Notion AI + Linear: is_sponsored: false, recommendation_strength: 'strong' — organic endorsements. Notion has a referral programme — affiliate link could replace the organic mention at zero credibility cost. Beehiiv sponsor_fit_score: 0.88 — high fit. Use estimated_cpm_usd: 35 to set a floor for future sponsor negotiations. Run track_product_trends across the last 12 issues to find your best partnership targets.","eval":{"F1":0.97,"latency_ms":7804,"cost_usd":0.000428}},{"tool":"generate_newsletter_products_section","description":"Format extracted newsletter products into a ready-to-paste 'Products in This Edition' section. Pass newsletter_id to use a cached extraction or pass products[] directly. Supports markdown/html and minimal/full styles.","input":{"newsletter_id":"swipe-file-issue-47","format":"markdown","style":"full"},"output":"## Products in This Edition\n\n### ⭐ Top Picks\n\n- **Notion AI** — saas\n  > *\"running my entire writing workflow through Notion AI for three months now. Genuinely the best $10\"*\n- **Linear** — saas\n  > *\"switched to Linear for project management. No affiliate link, just a real recommendation\"*\n\n### 👍 Endorsed\n\n- [Beehiiv](beehiiv.com/growth) — saas\n  > *\"newsletter platform built for growth. Start free at beehiiv.com/growth\"*\n\n---\n*Affiliate links help keep this newsletter free. Thank you.*","value_narrative":"Notion AI and Linear surface as 'strong' organic endorsements — prime candidates for affiliate programme signup (Notion has a referral programme). Beehiiv is a paid sponsor with call_to_action already resolved. The formatted section is ready to paste into any Substack/Ghost editor. Run track_product_trends to find which products recur across issues for priority affiliate outreach."},{"tool":"analyze_newsletter_sponsors","description":"Score sponsor sections from a cached newsletter extraction. Per-sponsor: CPM benchmark, read-through, sponsor_fit_score, CTA effectiveness. Top-level aggregates: sponsor_count, avg_read_through, avg_sponsor_fit_score, cta_rate. No AI cost. Call after extract_newsletter_products.","input":{"newsletter_id":"swipe-file-issue-47"},"output":{"newsletter_id":"swipe-file-issue-47","sponsors":[{"sponsor_name":"Beehiiv","estimated_cpm_usd":35,"estimated_read_through":0.61,"sponsor_fit_score":0.88,"call_to_action":"beehiiv.com/growth","cta_quality":"high","recommendation":"Strong fit for a writing-focused audience. Negotiate toward $38 CPM at renewal."}],"_meta":{"processing_time_ms":65,"ai_cost_usd":0,"cache_hit":true}},"value_narrative":"Beehiiv fit 0.88 = highly aligned sponsor for a writing audience. Use this score as leverage in renewal negotiations — low fit scores ($0.3) justify declining or repricing a sponsor. Track sponsor_fit_score across issues to see if a sponsor is genuinely relevant or just paying."},{"tool":"track_product_trends","description":"Identify rising and falling product trends across newsletter issues. Per trend: trend direction (rising/stable/falling), issues_present, total_mentions, avg_recommendation_strength (0–3 scale). Top-level: top_category (dominant category this period). Reads from cached extractions — no re-processing cost.","input":{"publication_id":"swipe-file","weeks":12},"output":{"publication_id":"swipe-file","trending_up":[{"product":"Notion AI","category":"saas","mention_velocity":3.1,"issues_mentioned":8,"trend":"hot"},{"product":"Linear","category":"saas","mention_velocity":1.4,"issues_mentioned":4,"trend":"rising"}],"trending_down":[{"product":"Roam Research","category":"saas","mention_velocity":0.2,"issues_mentioned":1,"trend":"fading"}],"_meta":{"issues_analyzed":48,"date_range":"12 weeks"}},"value_narrative":"Notion AI trending hot (3.1×) across 8 issues = strong reader resonance. Notion's referral programme pays $10–$50/conversion. Reach out NOW. Roam fading — don't pitch them. Stable products are affiliate candidates for long-term partnerships rather than launch promotions."}]}