create_article
ChatGPTCreate a new article on the site. Side effect: stores the article in RankBolt (not on the connected CMS until published or scheduled). Status defaults to draft; pass status 'scheduled' with scheduled_at to schedule it, or 'published' to publish immediately. Use update_article to change it afterwards.
create_tag
ChatGPTCreate a tag to organize articles.
delete_article
ChatGPTPermanently delete an article from RankBolt. This cannot be undone; confirm with the user before calling it. Does not remove a copy already published to an external CMS.
fetch
ChatGPTFetch the full content of one article returned by search (Markdown text plus metadata).
generate_articles
ChatGPTWrite one or more SEO-optimized articles from a brief, grounded in the site's context, and save them as drafts. Side effects: creates draft articles and uses the account's article credits. Takes 30-90 seconds; use it only when the user asks for new articles.
generate_featured_image
ChatGPTGenerate a featured image with AI and return its URL. Provide either an explicit image prompt or the article title to derive one. Side effect: uses the account's image credits; the image is not attached to an article until you pass the URL to create_article or update_article.
generate_seo_metadata
ChatGPTGenerate an SEO meta title and meta description for existing content.
get_article
ChatGPTGet one article by id, including its full Markdown content, metadata and status.
get_task
ChatGPTGet one task with what's needed to fix it: its description, findings (the stored data that flagged it, e.g. the audit check's result on the live page and the recommended fix), the fix guide when one was written in the dashboard, and the last live check. For a fix_in "code" task: find the code that renders the affected page or file in the site's repository, make the change, then call set_task_status with in_progress.
humanize_article
ChatGPTRewrite an article in place so it reads naturally, removing AI writing tells. Side effect: overwrites the article's content. Takes 30-60 seconds; use it only when the user asks for this rewrite.
list_articles
ChatGPTList the site's articles (summaries without body content), optionally filtered by status. Use get_article for the full content of one article.
list_media
ChatGPTList the files in the site's media library.
list_sites
ChatGPTList the sites this account can access, with the ids to pass as site_id. An API key is scoped to one of them.
list_tags
ChatGPTList the tags available on the site.
list_tasks
ChatGPTList the site's SEO tasks (the RankBolt task board, daily tasks included) in board order. Each task has fix_in: "code" when the fix is a change to the website itself (meta tags, headings, structured data, image alt text, robots.txt, llms.txt, sitemap, page speed), which a coding agent can make in the site's repository; "rankbolt" when it's done inside RankBolt (articles, keywords, integrations); "off_site" for other websites; "unknown" for tasks the user or the chat added by hand, which can be any of these (judge from the title). To find what to fix in code, pass fix_in ["code", "unknown"]. Done tasks are left out unless include_done is true. Call get_task for the findings behind a task.
reformulate_text
ChatGPTRewrite a piece of text in a given style.
search
ChatGPTSearch the site's articles by keywords (title, excerpt and body). Returns matching articles as citations; call fetch with an id for the full text.
set_task_status
ChatGPTMove a task to backlog, todo or in_progress on the RankBolt board. Use in_progress once the fix is made but not live yet. Tasks can't be marked done here: auto-check tasks complete through verify_task once the change is live, and the user ticks the others in the dashboard.
update_article
ChatGPTUpdate an existing article's title, content, slug, metadata, status or schedule. Only the provided fields change; the previous values of those fields are overwritten. Use get_article first when editing content so nothing is lost.
upload_media
ChatGPTDownload an image from a public URL and add it to the site's media library. Side effect: stores a copy of the file in RankBolt. Only use URLs the user provided or that came from generate_featured_image.
verify_task
ChatGPTCheck the live website for an auto-check task's change and mark the task done when it's confirmed. AI fetches the site's public pages, which takes 20-60 seconds. Call it only once the fix is deployed: a change that exists only in local code won't be found. Returns completed, a summary and what's still missing. Manual tasks are refused; the user confirms those in the dashboard.
whoami
ChatGPTWho is authenticated: the signed-in user and their sites (OAuth), or the site and owner behind the API key.