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.

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)

1. Sign up and complete onboarding at distribb.io (Distribb learns the business).
2. Connect the two things that matter most: the website/CMS and Google Search Console.
3. Confirm the site has a blog to publish to.
4. Audit the site before writing anything (/gsc-audit). Available on every plan.
5. Plan topic clusters, then do keyword research to fill them.
6. Write and publish, always including 1-2 backlink-exchange links.
7. Optimize pages stuck on page 2+ using GSC data (/optimize).

Slash Commands

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

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

Command-line helpers (optional)

The skill works fully with curl + jq (no install). These Python helpers ship as optional conveniences:

MCP Server (Cursor / Claude Desktop)

The MCP server exposes every Distribb endpoint as a native tool. 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.