Hands-Off SEO

View saved version →

---
name: hands-off-seo
description: Use when the user wants to manage SEO blog content for their website with Hands-Off SEO — adding a website, checking or approving the monthly post plan, reading, writing, editing or publishing a post, seeing Google results, or finding posts to optimize.
---

# Hands-Off SEO

Hands-Off SEO writes and publishes blog posts on a small business's website. Each month has a plan (post ideas grouped by topic); the owner approves the month's plan once, then posts are written ahead and published automatically on their dates to WordPress, WooCommerce, Shopify or Haravan. Google Search Console shows results and Hands-Off SEO suggests improvements. Every tool works on the signed-in user's data only.

## Pick the right tool

| User wants | Tool |
|---|---|
| Their websites, "how do I get more websites", or whether a website / Search Console is connected | `seo_sites` (a card plus one line; each account has a fixed website limit — never mention upgrading; other tools take the domain as `site`) |
| Add a website they own or manage | `seo_add_site` — the card shows what Hands-Off SEO learned and a button to continue setup on the web |
| Status ("how is my SEO going", "what needs me") | `seo_overview` |
| Google numbers (clicks, impressions, position, a date range) | `seo_results` |
| What to improve | `seo_opportunities`, then `seo_opportunity_action` / `seo_optimize_post` (propose, then apply — its card asks the user to confirm) |
| A month's schedule | `seo_month_plan` (optional `month` = YYYY-MM) |
| The plan waiting for approval | `seo_plan_review`; change it with `seo_edit_plan`; approve: `seo_approve_plan` — its card asks the user to confirm |
| Read a post or the full article | `seo_post` with `post_date` / `post_title` (the card opens the full article with its images) |
| Write a post now / retry / move / swap | `seo_post_action` with `post_date` / `post_title` |
| Publish a post now, written or not | `seo_publish_now` with `post_date` and/or words of its title — an unwritten one gets "Write and publish now" (written, then published at once, no review step); check the website is connected first (the card asks the user to confirm) |
| Cancel a scheduled post | `seo_remove_post` with `post_title` (its card asks the user to confirm) |
| A post that isn't on the calendar ("write a post about…") | `seo_add_post` — it's added at once for a date, with Undo on its card; it's written before that date and publishes on it (`write_now: true` also starts writing it now) |
| Change a post in plain words | `seo_edit_post` (the card shows old vs new and an Apply edits button), or `seo_apply_edit` with `post_title` when the user asks in chat (its card asks them to confirm) |
| Settings (auto-optimize, article length; see market, language, publish time) | `seo_settings`, `seo_update_settings` |
| Save a business fact or writing rule | `seo_remember` |
| Connect or fix WordPress / WooCommerce / Shopify / Haravan / Search Console | `seo_connect` (link to the web) |
| Manual editor, drag & drop calendar, uploads, image library, old posts, setup steps | `seo_open_web` |
| Progress of background work | `seo_job_status` |

## Rules

- Always call a tool for anything about the user's sites, plans, posts or results — never guess, never run a web search for them (not even for the domain), and never say you can't see their data. Never say something is saved, set, approved or running unless a tool returned it.
- Pass `locale` (vi or en) = the language of the user's latest message, not of a post title it quotes.
- Pass the website the user named or picked earlier in this chat as `site` on every call — don't ask "which site?" again in this chat. If none is known yet and the account has more than one running website, call the tool without `site` and let it ask; never take one from other chats. With exactly one running website, the tools use it and the answer names it.
- One card per answer: call only the tool that answers the ques

Preview of the first 4,000 characters. Read full instructions →