skills/sales-buzzsumo/SKILL.md
BuzzSumo platform help — content intelligence, trending topic discovery, content performance research, journalist database (700K+), influencer identification, monitoring alerts, and Search/Account/Backlinks REST APIs. Use when BuzzSumo search results are returning irrelevant content and you need better query filters, trending feeds aren't showing topics relevant to your niche, journalist database isn't surfacing the right reporters for your pitch, API call limits are exhausting too quickly on your plan, you need to pull BuzzSumo data into your dashboard or CRM via the API, content analysis isn't showing accurate share counts, or you're unsure whether BuzzSumo is worth $199/mo vs cheaper alternatives. Do NOT use for social listening strategy across tools (use /sales-social-listening) or media relations strategy (use /sales-media-relations).
npx skillsauth add sales-skills/sales sales-buzzsumoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
If references/learnings.md exists, read it first for accumulated platform knowledge.
Ask the user:
What do you need help with?
What's your plan?
What's your primary use case?
If the user's request already provides most of this context, skip directly to the relevant step.
| If the question is about... | Route to... |
|---|---|
| Social listening strategy across tools | /sales-social-listening [question] |
| Media relations strategy (not BuzzSumo-specific) | /sales-media-relations [question] |
| Influencer marketing strategy | /sales-influencer-marketing [question] |
| SEO / keyword research | /sales-seo [question] |
| Content enablement for sales reps | /sales-content [question] |
If it's a BuzzSumo-specific question, continue to Step 3.
Read references/platform-guide.md for the full platform reference — capabilities, pricing, data model, API details, integration recipes, code examples.
Answer the user's question using only the relevant section. Don't dump the full reference.
Focus on the user's specific situation:
If you discover a gotcha or tip not covered in references/learnings.md, append it there.
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
/sales-social-listening — Social listening strategy, platform comparison, monitoring setup/sales-media-relations — Media relations strategy, journalist databases, pitch writing/sales-influencer-marketing — Influencer marketing strategy across platforms/sales-seo — SEO strategy, content optimization, keyword research/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do -a claude-codeExample 1: "What content is performing best for my competitor?" → Use Content Analyzer: search competitor's domain, filter by last 6 months, sort by total engagements. Compare their top 10 articles against yours. Look for topic gaps they're winning on.
Example 2: "How do I find journalists who cover AI startups?" → PR & Comms plan required. Filter media database by beat "artificial intelligence" + "startups", sort by recent publication activity. Check their social engagement metrics to prioritize active journalists over dormant ones.
Example 3: "How do I pull trending articles into my own dashboard via the API?"
→ Use Search API: GET https://api.buzzsumo.com/search/articles.json?q=your+topic&api_key=YOUR_KEY. Parse the JSON response for article URLs, share counts, and publication dates. Mind the 100 calls/month limit — cache aggressively.
Content search returns irrelevant results Filter by date range (last 3-6 months), specific domains, and minimum engagement thresholds. Use exact phrase matching with quotes. Exclude known noise domains. For B2B content, try searching specific industry publications rather than broad topic keywords.
API calls exhausting too quickly With only 100 Search API calls/month on free keys, cache every response locally. Batch requests by building comprehensive queries (multiple keywords in one call). Consider if Ahrefs Content Explorer API ($199/mo with 1000x more capacity) better suits your volume needs.
Trending feeds show nothing relevant to my niche BuzzSumo trends skew toward high-volume B2C content. For niche topics: use Content Analyzer with specific industry terms instead of Trending Feeds. Set up Monitoring Alerts with narrow keyword combinations for your specific space.
tools
Waitlister platform help — pre-launch waitlist platform with hosted landing pages, points-based viral referrals, built-in email broadcasts, REST API, and five HMAC-signed webhook events. Use when choosing Free (100 subscribers) vs Launch $15/mo (unlimited subs, referrals + broadcasts) vs Growth $49/mo (API, webhooks, Klaviyo/Mailchimp/Kit sync, fraud detection unlock here) vs Business $129/mo, building a webhook handler that verifies X-Webhook-Signature, webhooks auto-disabled after 10 consecutive failures, API signups bypassing referral fraud detection because client_ip/fingerprint weren't forwarded, granting bonus points or pulling top referrers via the API for reward fulfillment, broadcast send caps forcing an ESP handoff, automating without Zapier (Waitlister has none — webhooks/API only), or comparing Waitlister vs LaunchList/KickoffLabs/GetWaitlist/Prefinery. Do NOT use for list-growth strategy (use /sales-audience-growth) or LaunchList help (use /sales-launchlist).
development
LaunchList platform help — viral pre-launch waitlist platform with one-time lifetime pricing, gamified referrals (queue jumping, leaderboard, position inflation), embed widget + custom form POST endpoint, new_user/email_verify webhooks, Zapier, and spam protection. Use when choosing Free (100 submissions) vs Launch $29 (500) vs Grow $79 one-time (10K — webhooks, Zapier, team unlock here), wiring waitlist signups into Mailchimp/Kit/HubSpot or a CRM because LaunchList has no email broadcast system, needing programmatic access when there is no public REST API yet (form POST + webhook workaround), building a webhook handler with referred_by referral attribution, blocking disposable-email or bot signups on a viral waitlist, a custom signup form not submitting or not tracking referrals, or comparing LaunchList vs KickoffLabs/Viral Loops/Prefinery/GetWaitlist on one-time vs subscription pricing. Do NOT use for list-growth strategy (use /sales-audience-growth) or KickoffLabs help (use /sales-kickofflabs).
development
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referrals, with REST API (`app.upviral.com/api/v1/`, form-encoded `uvapikey` + `uvmethod`), Callback-URL webhooks, IP-based fraud detection, and 30+ ESP/CRM integrations. Use when campaigns aren't tracking referral points, deciding between Starter $79/mo (10K leads, NO API) vs Business $119/mo (API + webhooks) vs Premium $319/mo, the API erroring because you're on Starter where API/webhooks are gated, building a pipeline with `add_contact`/`get_leads`/`get_leads_points`, interpreting same-IP suspicious-referral flags, or picking UpViral over Viral Loops/Vyper/Gleam. Do NOT use for newsletter audience growth (use /sales-audience-growth), KickoffLabs help (use /sales-kickofflabs), merge-tag referrals (use /sales-referralkit), SparkLoop recommendations (use /sales-sparkloop), or multi-level Level 1/2/3 tracking (use /sales-referralhero).
tools
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with REST API, webhooks, Zapier, native ESP connectors, multi-level referral tracking (Level 1/2/3), coupon groups, anti-fraud, and a 5,000 calls/hour limit. Use when referrals aren't tracking, deciding between Free (no API) vs PRO $199/mo (API + webhooks) vs PREMIUM $399/mo (ReCaptcha + SMS Verification), auth failing with `no_token` or `Bearer` vs `X-API-Key`, Level 2/3 counts off from calling `level_2_all_referrals` not `level_2_referrals`, bulk 429s from not chunking the 500-transaction `add_bulk_transactions` limit, coupon endpoints 404 without a coupon group, reward fulfillment (`promote` then `unlock_promoted_reward`) failing, or comparing to SparkLoop/ReferralKit/GrowSurf. Do NOT use for newsletter audience growth (use /sales-audience-growth), merge-tag referrals (use /sales-referralkit), SparkLoop recommendations (use /sales-sparkloop), or affiliate strategy across tools (use /sales-affiliate-program).