Install as a skill
npx skills add Bomx/distribb-skill
Distribb SEO Skill
SEO automation for AI agents. Use any AI model you want. Distribb provides the infrastructure: real keyword data, backlinks from real businesses, a Google Search Console audit, CMS publishing, content calendar, social repurposing and direct social posting, Google Business Profile management (live reviews, public replies, Google posts), Microworkers campaign management, and analytics.
Publish reels with comment-triggered DMs
Upload a reel, select the connected Instagram handle, publish its caption and configure a keyword-triggered DM through the API, MCP tools or CLI. The response includes the saved post ID and delivery status. Retry or update the rule on that existing post without publishing again. See the social publishing guide for requests and examples.
Use any integration
Everything the user connects on Distribb's Integrations page is available to the agent: ad accounts (Meta, Google, TikTok, LinkedIn and more), social accounts with their DMs, comments and analytics, Google Search Console and Business Profile, analytics tools (Google Analytics, PostHog, Stripe...), bank accounts, outreach and email tools, databases, GitHub, and the new integrations Distribb keeps adding. GET /api/v1/integrations/catalog shows what is connected and gives the connect link to send the user (connecting always stays with them; the agent never collects credentials), GET /api/v1/agent-tools lists the tools, and POST /api/v1/agent-tools/call runs one with the same gates and preview-then-confirm rule as Distribb's own agent. Run /integrations, or see the integrations playbook. Playbooks for SEO, social media, outreach and paid ads ship with the skill.
Quick Start
export DISTRIBB_API_KEY=your_key_here
No installation required for the API. The skill uses curl and jq. The first time it loads, it walks the user through the proper SEO process: account + onboarding, connect website + Google Search Console, audit, topic clusters, write + backlink, optimize.
The proper SEO process (what this skill runs)
- Sign up and complete onboarding at distribb.io (Distribb learns the business).
- Connect the two things that matter most: the website/CMS and Google Search Console.
- Confirm the site has a blog to publish to.
- Audit the site before writing anything (
/gsc-audit). Available on every plan.
- Plan topic clusters, then do keyword research to fill them.
- Write and publish, always including 1-2 backlink-exchange links.
- Optimize pages stuck on page 2+ using GSC data (
/optimize).
Slash Commands
| Command | What it does |
|---|
/distribb | Overview, account status, and the proper SEO process |
/distribb-setup | Check the API key, confirm website + GSC are connected, enable the commands |
/gsc-audit <domain> | Full SEO audit (CTR, decay, page-2, cannibalization, topic clusters, competitor, on-page) |
/keyword-research <seed> | Keyword ideas with volume and difficulty |
/write-article <keyword> | Research, write, link, backlink, and publish one article |
/optimize | Rewrite pages stuck on page 2+ from GSC data |
/backlinks | Check credits and targets, explain the exchange |
/content-calendar | List, schedule, and manage articles |
/ai-visibility | Find where AI engines should recommend you, and which listicles to pitch |
/news-writer <site-url-or-niche> | Turn fresh news in your niche into grounded drafts and queue them in Distribb to autopublish |
/statistics-page-writer <topic> | Deep-research and publish a sourced statistics page journalists love to link to |
/youtube-motion-video <topic> | Make a faceless motion-collage explainer video ("In a Nutshell" docu style), YouTube-SEO it, and publish it to the connected YouTube channel |
/instagram-carousel <article-id-or-keyword> | Turn one article or keyword into a viral, save-driven Instagram carousel (cover hook, one idea per slide, comment-for-link play), publish it, and close the SEO loop with a companion article |
/review-video <competitor> | Compile REAL, verified competitor reviews into a " reviews" video, position your business as the alternative, and publish to YouTube + a companion article |
/gbp | Google Business Profile manager: live review triage, public review replies, Google posts, post analytics |
/gov-backlinks | Register your business in the free government directories (SAM.gov, the SBA small business listing, state vendor portals) for real .gov profile backlinks |
|
Command files live in commands/. If they are not auto-registered by your installer, run /distribb-setup or copy commands/*.md into your project's .claude/commands/ folder.
Plans
| Plan | Keyword data | Backlinks | Who writes |
|---|
| Agentic Mode ($49/mo, 3-day trial) | Distribb-provided | Unlimited exchange | You (the agent) |
| Pro ($97/mo) | Distribb-provided | Unlimited exchange | Distribb writes + publishes for you |
| Accelerator | Distribb-provided | Unlimited exchange | You + done-for-you AI-search distribution |
The free Agentic plan ($0/mo) is deprecated and no longer offered to new users. Current plans are Agentic Mode at $49/month and Pro at $97/month.
Every plan can run the audit and use the content calendar. See references/plans-and-backlinks.md for full detail. Current pricing is at distribb.io.
Commands (raw API)
# Projects
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
https://distribb.io/api/v1/projects | jq .
# Business context (brand voice, competitors, custom instructions)
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/business-context?project_id=42" | jq .
# Google Search Console (powers the audit + optimizations)
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/search-console?project_id=42&days=90&limit=100" | jq .
# Keyword research
# Legacy Free Agentic accounts: returns HTTP 402 with `error: "byo_keys_required"` until
# the user saves their own DataForSEO or Ahrefs API key in Settings.
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "crm software", "project_id": 42}' \
https://distribb.io/api/v1/keywords/search | jq .
# Internal links
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/internal-links?project_id=42&keyword=crm+software" | jq .
# Backlink targets
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/backlink-targets?project_id=42&keyword=crm+software" | jq .
# Create article
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project_id": 42, "keyword": "best crm", "title": "Best CRM", "content": "<h2>...</h2>", "status": "Draft"}' \
https://distribb.io/api/v1/articles | jq .
# Optimization suggestions (rewrite page-2 pages)
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project_id": 42}' \
https://distribb.io/api/v1/suggestions/run | jq .
# Publish to CMS
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
https://distribb.io/api/v1/articles/123/publish | jq .
# Edit an ALREADY-PUBLISHED article and push the change to the live post.
# The PUT saves inside Distribb; "sync": true (or the /sync call) updates the
# live post in place. Supported on WordPress, Webhook, Shopify, Webflow, Wix,
# Ghost, GoHighLevel, Framer and Notion.
curl -s -X PUT -H "Authorization: Bearer $DISTRIBB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title": "The Corrected Title", "sync": true}' \
https://distribb.io/api/v1/articles/123 | jq .
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
https://distribb.io/api/v1/articles/123/sync | jq .
# Integrations
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/integrations?project_id=42" | jq .
# Google Business Profile: status + live reviews + public reply + posts
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/gbp/status?project_id=42" | jq .
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/gbp/reviews?project_id=42&has_reply=false" | jq .
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project_id": 42, "review_id": "<review_id from /gbp/reviews>", "message": "Thanks Sarah!"}' \
https://distribb.io/api/v1/gbp/reviews/reply | jq .
curl -s -X POST -H "Authorization: Bearer $DISTRIBB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project_id": 42, "text": "Spring checks now booking", "link": "https://acme.com/offer"}' \
https://distribb.io/api/v1/gbp/posts | jq .
# Microworkers campaigns
curl -s -H "Authorization: Bearer $DISTRIBB_API_KEY" \
"https://distribb.io/api/v1/microworkers/campaigns?project_id=42" | jq .
The Audit
Real SEO starts with an audit, not with publishing. /gsc-audit <domain> (or references/audit-playbook.md) runs nine analyses from Distribb's own Search Console connection and a live crawl: CTR optimization, content decay, striking-distance / page-2 keywords, keyword cannibalization, dead pages, brand vs non-brand health, topical authority clusters (topic cocoons), competitor gaps, and basic on-page checks. It ends with a prioritized action plan wired into Distribb. Works on every plan.
Backlink Exchange
Distribb connects real businesses that exchange backlinks. When your article includes a link to a network partner, Distribb detects it on submission and credits your project. More given = more received. Every current plan gets unlimited exchange access; legacy Free Agentic accounts receive 1 backlink/month. These are high-DR links from legitimate business websites.
Bring-Your-Own-Keys (legacy Free Agentic accounts)
The free Agentic plan is deprecated and no longer offered to new users. Accounts still on it do not bundle keyword data, so those users save their own DataForSEO or Ahrefs API keys at distribb.io/settings#seo-keys. All other endpoints (articles, integrations, backlinks, audit) work normally without any keys.
When /api/v1/keywords/search is called from a legacy Free Agentic account with no keys saved, the response is HTTP 402 with "error": "byo_keys_required" and an instructions_for_agent string. Surface that string to the user verbatim and do not retry until they have saved credentials.
Microworkers Campaign Management
Distribb can create/register project-scoped Microworkers Basic Campaigns, list worker slots/submissions, and rate submissions as OK, NOK, or REVISE. Campaign creation requires project_id, title, description, and template_html; optional fields include platform, campaign_type, category_id, available_positions, payment_per_task, proof settings, and timing controls.
References
Sub-skills
| Folder | What it does |
|---|
90-day-seo-sprint/ | Run the Distribb 90-Day SEO Sprint: a phased program (Pre-launch / Foundation / Content Engine / Authority) built on the endpoints in this skill. Use when the user asks for an "SEO sprint", "90-day SEO plan", or "where do I start with SEO". |
Command-line helpers (optional)
The skill works fully with curl + jq (no install). These Python helpers ship as optional conveniences:
| File | What it is |
|---|
distribb_cli.py | A thin CLI over the same API (projects:list, articles:create, keywords:search, suggestions:list, ai-visibility:get, ai-visibility:prompts:add, etc.). pip install requests python-dotenv, then export DISTRIBB_API_KEY=.... |
distribb_research.py | A standalone original-data research pipeline (plan -> scrape -> analyze) that produces a sourced hook + data table to weave into articles. Uses your own AI key; never invents data. |
distribb_writer.py | A reference implementation showing how to write an SEO article locally with your own AI and submit it via the API. Meant to be modified or swapped out. |
news_topics.py | Used by /news-writer. A stdlib-only Google News RSS scraper (no API key, no install) that surfaces fresh, recent headlines for a niche and writes news_topics_export.csv next to itself. |
MCP Server (Cursor / Claude Desktop)
The remote MCP server exposes SEO workflows and social publishing with comment-triggered DMs as native tools. See the API docs for setup.
Get an API Key
Sign up at distribb.io. Your API key is in Settings after you complete onboarding.
