Hands-Off SEO

Card-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_card_state

Changes 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.

seo_update_settings

Changes 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_plan

Progress / 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_job_status

Use 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_connect

Drafts 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_edit_post

Card-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_draft_plan

Shows 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_month_plan

Shows 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_sites

Returns 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_open_web

Use 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_opportunities

Applies 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_optimization

Improve 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_optimize_post

Publishes 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_confirm_publish

Use 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_publish_now

Card-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_new_posts

Use 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_results

Shows 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_plan_review

Shows 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_overview

Saves 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_remember

Removes 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_undo_add_post

Shows 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

Show 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_settings

Setup 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_setup

Acts 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_post_action