SEO with Distribb

Read a saved social post, publishing results and comment-for-guide settings. Reads back a saved provider DM rule before reporting active. An unverified, pending or failed rule needs configuration on this existing post, not another publish.

get_social_post

What the Google Business Profile brought in: calls, direction requests, website clicks, profile views and bookings for the last N days against the period before, plus the searches that showed the profile. Google publishes these 2-3 days late.

gbp_performance

Google Business Profile connection status and review stats for a project.

gbp_status

Run keyword research for a seed keyword: search volume, difficulty, cost per click, and related keyword ideas in the project's market.

keyword_research

List connected CMS and publishing integrations (WordPress, Webflow, Shopify, Wix, Framer, Ghost, Notion, and more) and their status.

list_integrations

List live Google Business Profile reviews for a project. Filter to unreplied reviews with has_reply false.

gbp_reviews

List articles for a project or the whole account, newest scheduled date first. Filter by status (Draft, Planned, Published) and by a scheduled-date window. Each row includes the live url, claimed (finished content is already saved, so Distribb will not write it) and distribb_is_writing (Distribb's writer has started it).

list_articles

List the verified backlinks a project has received and given through the Distribb exchange, with source and target URLs.

list_backlinks

List this project's social accounts, usernames and account_id values. Match the requested handle before publishing; projects can have several Instagram accounts.

list_social_accounts

List the improvements Distribb suggested for existing pages from Google Search Console data, with their status (pending, ready, published, rejected) and target page.

list_optimizations

List every project (website) on the account with plan, publishing cadence, and CMS connection status.

list_projects

List a project's recent saved social posts, including drafts, scheduled and published posts. Use after an uncertain publish response to find the saved post before retrying. Get a specific post to verify its delivery rule.

list_social_posts

Publish an article now to the connected CMS (WordPress, Webflow, Shopify, and other supported platforms).

publish_article

Push a ready optimization to the live page on the connected site. Some rewrites of articles already live on a CMS can only be applied by hand; those return an error saying so and change nothing.

publish_optimization

Publish a caption and uploaded media to the selected connected accounts, or schedule in UTC. For an Instagram reel, pass the uploaded video in media_files. For comment-triggered DMs, set is_comment_for_guide true and supply comment_for_guide_config with match_mode keyword, trigger_keyword, delivery_method dm, delivery_url, custom_message containing {url}, and is_active true. Always select account_id from list_social_accounts. Returns saved post IDs; verify publishing and delivery with get_social_post. Retry DM setup using configure_social_post_auto_reply on the same post, never by republishing.

publish_social_post

Distribb's playbooks for agents: seo, social-media, outreach, paid-ads, and integrations (which connections to set up first and how to use each one). Read the relevant one before planning work in that area. Without a topic, lists them.

get_playbook

Post a public owner reply to a Google Business Profile review. The reply goes live on Google.

gbp_reply_review

Take a screenshot of a public web page, such as the homepage of a product ranked in a listicle, and host it. Runs in the background: the first call returns status processing; call again with the same url after about 20 seconds to get image_url, or a reason if the page could not be captured cleanly.

screenshot_page

Google Search Console performance for a project: clicks, impressions, positions, and top queries over the last N days.

search_console_performance

Set how many articles a month the project gets: 8 (premium, longer articles), 30 (one a day) or 5 (backlinks focused); Accelerator members can also choose 60 or 90. Only plans included in the account are accepted, so nothing is billed. get_project lists them under article_plan, with the recommended one.

set_article_plan

Start keyword research and the first articles for a project (spends research credits). For an account that has not finished onboarding, this also finishes it: the account leaves the setup wizard and the calendar fills with planned articles. Returns site_scan_running while Distribb is still reading the website.

start_onboarding

Update an article: title, content, keyword, meta_description, article_style, status, category, scheduled_date (null to unschedule), feature_image, alt_text. Saving 2,000+ characters of content on a Planned article claims it: Distribb will not write it and publishes the saved content exactly as sent on its date. Refused with already_being_written once Distribb's writer has started the article. Set sync true to also push the edit to the live CMS post of a published article.

update_article

Update project settings: ai_instructions, tone, publish_time, timezone, backlinks_network, business_description, primary_location, and any writable key shown by get_project. Pass only the keys to change.

update_project

Host an image for an article and get back its public URL. Send exactly one of image_base64 (PNG, JPG, WebP or GIF, 12 MB max), image_url (a public image URL to copy), or file (an image file from this conversation).

upload_image

Host an existing image (12 MB max) or MP4/MOV video (64 MB max) for social publishing. Supply a public media_url or an attached file. Returns media with type and s3_url for publish_social_post. Does not publish a post.

upload_social_media