seo_add_idea
ChatGPTAdds one of the ideas on the last-days calendar card to this month's calendar — it's written and published on that date. In ChatGPT only the idea's Add button on the card calls it. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_add_post
ChatGPTAdds one post to the calendar — the user's own title, or a topic picked for it. It's written before its date and publishes on that date. The card shows the date, and Undo until it's published. An idea picked from a calendar card goes in with that idea's title and date ("the second one", "the SEO one"). Without a date it takes the nearest free day from tomorrow; write_now=true also starts writing it now. It goes in even when the month already has its planned number of posts.
seo_add_site
ChatGPTSaves a website the user owns or manages to their Hands-Off SEO account and reads its public pages (respecting robots.txt) to learn the business: summary, products or services, topic ideas. It publishes nothing. The card shows what Hands-Off SEO learned and a button to continue setup (products, topics, roadmap) in the web app. Re-adding a website that is mid-setup shows it again.
seo_apply_edit
ChatGPTUse when the user wants the drafted edits for a post (the latest ready draft) saved into it. Shows the edits on a card; they're saved — and a published post is updated on the website too — only when the user clicks Apply edits on it. Name the post with post_date and/or words of its title — the card names the post before anything happens. It changes nothing: the card asks the user to confirm with its button. Call it when the user asks — don't ask in chat, don't call it again, and don't say it's done until the card shows it.
seo_approve_plan
ChatGPTUse when the user wants a month's plan approved. Shows the plan on a card naming the website, month, number of posts and date range; it's approved only when the user clicks Approve plan on it — then the month's posts are written and published automatically on their dates, without asking again. A plan that's already approved shows the new posts added to it since; they're approved the same way (Approve N new posts). Without month: the plan waiting for approval. This is the only approval — there is none per post. It changes nothing: the card asks the user to confirm with its button. Call it when the user asks — don't ask in chat, don't call it again, and don't say it's done until the card shows it.
seo_card_state
ChatGPTCard-only: tells a calendar or post card whether it was opened only to find a post that another card now acts on — then that card hides itself. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_confirm_apply_edit
ChatGPTSaves the edits the user just confirmed into the post; a published post is updated on the website too. Takes only the confirmation from seo_apply_edit; in ChatGPT only the card's Apply edits button calls it. Never call it without that confirmation. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_confirm_approve_plan
ChatGPTApproves the plan the user just confirmed: the month's posts are written and published automatically on their dates. It also approves the new posts an approved plan's card lists. Takes only the confirmation from seo_approve_plan; in ChatGPT only the card's Approve plan button calls it. Never call it without that confirmation. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_confirm_cancel
ChatGPTCancels the post the user just confirmed: it leaves the calendar and won't be written or published. Takes only the confirmation from seo_remove_post; in ChatGPT only the card's Cancel post button calls it. Never call it without that confirmation. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_confirm_optimization
ChatGPTApplies the optimization changes the user just confirmed to the live post on the website (same URL). Takes only the confirmation from seo_optimize_post apply; in ChatGPT only the card's Apply changes button calls it. Never call it without that confirmation. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_confirm_publish
ChatGPTPublishes the post the user just confirmed — public at once, can't be undone. Takes only the confirmation from seo_publish_now; in ChatGPT only the card's Publish now button calls it. Never call it without that confirmation. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_connect
ChatGPTUse when the user asks how to connect, set up, reconnect or fix WordPress, WooCommerce, Shopify, Haravan or Google Search Console, or when another tool reports a missing connection. Returns a link to the connection page on the web; credentials are entered there, never in chat — never ask for or accept passwords, app passwords or tokens.
seo_draft_plan
ChatGPTCard-only: drafts the plan of a month that has none, when its plan card opens or the user taps Use these topics on it (those topics are pinned to that month first); the card then shows the plan with Approve plan. For a plan with too few posts it lists topics to add (add_topics) and adds the ones the user taps (topic_ids). In a plan that's already approved, the added topics' posts wait for Approve N new posts on the card; drafting writes and publishes nothing. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_edit_plan
ChatGPTChanges a month's plan that is waiting for approval: remove or restore items (item_ids), add a post idea (text) under a topic (topic_id), or regenerate it. create drafts a plan for a future month that has none; the draft runs in the background and its card shows the plan with Approve when ready. create isn't available for this month in its last days; the result then lists the options for those days. Nothing is written or published.
seo_edit_post
ChatGPTDrafts a change to a written post (found by post_date and/or post_title) from the user's request, e.g. 'add a pricing section' or 'shorter intro'. Nothing changes on the post or the website: when the draft is ready, the card shows the new text next to the old. Not available while the post is still being written. The draft is applied with seo_apply_edit.
seo_job_status
ChatGPTProgress / result of background work (writing, publishing, editing, optimizing…) by job_id from an earlier result. Cards follow their own work — call only when the user asks. Setup work answers with the setup step card.
seo_month_plan
ChatGPTShows a month's post calendar: which post publishes on which day and its status, plus topics that are rising or coming into season. month picks another month (default: this month). In the last days of a month without a plan, the result lists the options for those days.
seo_open_web
ChatGPTReturns a link to a screen of the web app: editor (manual editing, images, versions), calendar (drag & drop, add topics; month), post, optimize (compare changes), train (business, market, language, products, topics, voice, documents), images, sync_old (import old posts), settings (connections, auto-optimize), results, setup (finish setting up a website). Billing, prices, trials and plans for Hands-Off SEO aren't handled in ChatGPT; account settings are at agentdojo.io.
seo_opportunities
ChatGPTUse only when the user asks what to improve: posts worth optimizing (losing traffic, close to the top, low click rate) and topics worth adding, from Google data.
seo_opportunity_action
ChatGPTact = do it (optimize kind → it drafts improvements, a preview — applying them later changes the live post; expand kind → adds posts to month this/next, overflow keep|move when that month is full) · dismiss (60 days) · snooze (7 days). Ask first before act.
seo_optimize_post
ChatGPTImprove a published post (named with post_date and/or post_title) from its Google data. propose (default; optional note = the user's tip) drafts changes in the background — a preview the card shows next to the current text; nothing changes. apply shows the proposed changes on a card; the live post changes only when the user clicks Apply changes on it. It changes nothing: the card asks the user to confirm with its button. Call it when the user asks — don't ask in chat, don't call it again, and don't say it's done until the card shows it. Name the post by title and date, never an id. discard drops the proposal.
seo_overview
ChatGPTShows a website's general status on a card ("how is my SEO going", "what needs me"): what needs the user, this week's posts, connections, a short Google headline and opportunities. Google numbers for a date range are in seo_results. A website still being set up shows its setup card. Billing, prices, trials and plans for Hands-Off SEO aren't handled in ChatGPT; account settings are at agentdojo.io.
seo_plan_review
ChatGPTShows a drafted monthly plan: posts grouped by topic, with the publish date range. Without month it shows the plan waiting for approval. Approving is seo_approve_plan; changes are seo_edit_plan. A month's number of posts follows its topics (4–8 posts each); there is no posting frequency. In the last days of a month without a plan, the result lists the options for those days.
seo_post
ChatGPTShows one post, written or planned, found by post_date and/or post_title (no calendar needed): status, publish date, cover, Google preview, word count, section outline, and whether the website is connected. Covers requests to read, see or show a post or its full article, also "here / in the chat". For a written post, the card's "Read full post" opens the complete article with all its images in the chat.
seo_post_action
ChatGPTActs on one post on the calendar, named by post_date and/or post_title. write_now: starts writing the post now. It still publishes on its scheduled date. Its card shows the progress, then the finished post with the full article; the same post asked again returns that post. retry: retries a post whose writing or publishing failed. move: moves the post to date (YYYY-MM-DD); force=true moves it into a month that already has its usual number of posts. swap: replaces the post — without job_id it returns 3 ideas; with job_id and choice, or a title, it switches to that one. move and swap change the calendar; write_now and retry start writing.
seo_publish_now
ChatGPTUse when the user wants a post published now. Shows a card; the post goes live — at once, and it can't be undone — only when the user clicks Publish now on it. Not written yet: its card offers Write and publish now (it's written, then published at once, without a review step). Requires a connected website: if you don't know whether it is, check seo_sites first; not connected → call seo_connect what=cms instead. Name the post with post_date and/or words of its title — the card names the post before anything happens. It changes nothing: the card asks the user to confirm with its button. Call it when the user asks — don't ask in chat, don't call it again, and don't say it's done until the card shows it.
seo_remember
ChatGPTSaves a business fact or writing rule for the named website; future posts use it. about=business for facts (prices, policies, opening hours, languages supported, what makes them different…), about=voice for how posts should sound (tone, words to use/avoid). Returns what was saved. Works while the website is still being set up. Never pass passwords, keys or tokens.
seo_remove_new_posts
ChatGPTCard-only: removes the new posts waiting for approval in a month whose plan is already approved — the ones its card lists (count). They were never written, so nothing leaves the website; the month's total drops by that many. If the waiting posts changed since the card showed them, nothing is removed and the card shows them as they are now. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_remove_post
ChatGPTUse when the user wants to cancel a post that isn't published yet. Shows the post on a card; it's cancelled only when the user clicks Cancel post on it — then it leaves the calendar (a draft on the website goes too) and won't be written or published. Name the post with post_date and/or words of its title — the card names the post before anything happens. It changes nothing: the card asks the user to confirm with its button. Call it when the user asks — don't ask in chat, don't call it again, and don't say it's done until the card shows it. A published post stays on the website — removing it happens on the web.
seo_results
ChatGPTUse for questions about Google performance: clicks, impressions, average position, a date range (7d, 28d = last 28 days, 3mo), by product. Shows one card; reply with the summary's one line of numbers. Never report zeros when there is no data.
seo_settings
ChatGPTShow a website's settings: auto-optimize, article length, market and article language, publish time (09:00 in the market's time zone), and whether the website and Search Console are connected. There is no posting frequency setting. Billing, prices, trials and plans for Hands-Off SEO aren't handled in ChatGPT; account settings are at agentdojo.io.
seo_setup
ChatGPTSetup of a website that was just added. action=website re-reads the website's public pages, or changes its address (url) or platform. Choosing products, topics and the roadmap is done in the web app (seo_open_web screen=setup); business facts the user types are kept with seo_remember. The other actions belong to the web setup flow: save_business, pick_topics, suggest_topics, confirm_topics, set_roadmap, finish (plans month 1; the owner still approves it).
seo_sites
ChatGPTShows the websites in the user's Hands-Off SEO account on a card: whether each is set up and whether the website and Search Console are connected. Covers which websites the user has, "how do I get more websites", adding one without an address yet, and checking a connection before publishing. Each account has a fixed website limit; the result says how many more fit. With several websites and none named, the card lists them to pick from. Billing, prices, trials and plans for Hands-Off SEO aren't handled in ChatGPT; account settings are at agentdojo.io.
seo_undo_add_post
ChatGPTRemoves a post the user just added, before it's published: stops its writing and takes it off the calendar (a draft on the website goes too). Takes only the undo code from adding it; in ChatGPT only the card's Undo button calls it. Show the card; the user confirms with the button. Don't say it's done until the card reports it.
seo_update_settings
ChatGPTChanges a website's settings and reports which one changed: auto-optimize on/off (when a post's traffic drops, it rewrites and republishes the live post, keeping the old version so it can be undone) and/or the article length for posts written from now on (short ≈ 1,200 words, standard ≈ 1,600 — the default, long ≈ 2,000; posts already written keep theirs). Settings left out stay as they are. Market and article language are set in the web app (Train → Overview), connections in its Settings.