---

name: seo-keywords description: SEO keyword METHOD — how to choose the keywords a piece is built on, how the merchant sees them (the review card), and how to apply a correction they ask for in plain language. Read this ONLY when a task-content-publish node is choosing or revising keywords. It has no entry of its own and must never be entered directly. tags: [internal, marketing] license: MIT-0

Choosing and correcting SEO keywords

The merchant picks them on the Quick setup card; the keywords node turns those picks into the per-channel set, and the review card shows that set to the merchant with its figures. This skill is the method for both, plus what to do when they ask to change them.

Where the keywords come from

1. The merchant gave them — in the Quick setup card or outright in their message. Those ARE the keywords — a pre-filled default they left standing included, however loosely it fits the products. Do not silently add to them, drop them, or "improve" them, and do not go looking for replacements. They are how the piece gets found, not what it is about: the featured products and the angle the merchant asked for are the subject, and a keyword — above all one the card pre-filled as a default — is woven into that, never written to; a pre-filled default the products cannot honestly carry stays in the SET and out of the COPY (task-content-publish → compose owns that call).
2. The merchant left a channel's row empty — that is their answer, and the piece carries no keywords on that channel (the card says so: "none picked — use no keywords at all"). GET_CHANNEL_KEYWORD_CANDIDATES — one group per channel, each already ranked and each carrying the figure behind it, a Google Trends interest score (0–100) and its growth — is what the card offered them to pick from, where the numbers for their picks come from, and what you show when they ASK for keywords; it never fills a row they left empty. When you do show candidates, pass over one that does not fit what the piece is about: ranking high is no reason to keep it. GET_TRENDING_KEYWORDS is a different thing — Google Trends only, no platform dimension and no seeds — so it answers "what is rising in this category", not "what should this Instagram post carry".

Quote those figures as what they are. The score is RELATIVE interest, not a search volume: never turn it into "8,100 searches a month" or any other absolute count. A hashtag candidate carries no post count at all — Meta's API does not provide one — so never quote "987K posts" or a number like it, for any hashtag, however confident it feels. If the merchant asks how popular a hashtag is, the honest answer is the trend figure you were given and that post counts are not available.

Never invent a keyword you have no signal for.

Telling the merchant: the card speaks, not you

The keyword picks ride the review card with their figures — the merchant sees the set there as theirs (they saw it on the Quick setup card and left it standing, which makes it their choice). The turn a draft lands carries NO prose (the app hides it), so there is no keyword line to write at hand-over. When the merchant ASKS about the terms, name them as theirs — "written around your keywords: A, B, C" — never as a set of yours to defend, never with an invented figure, and never ending in a question mark.

When the merchant asks to change them

They will say it in plain language ("drop the second one", "use winter gear instead of snowboards", "these are too generic"). Apply it literally:

• Remove exactly what they named; keep everything they did not mention.
• A removal means FEWER — never a back-fill. "Don't use #summerdress" asks for a set without #summerdress, not for a substitute: ship the shorter set. A term the system slots into the hole the merchant just emptied is a claim their brand never made, surfacing exactly where they just intervened ("drop #vegan, our certification lapsed" must not resurrect as #organic). The thinner set is still theirs — thinner is what they asked for. A candidate enters only when they ask for a REPLACEMENT or a fresh set (the bullets below); everything they typed or kept stays exactly as it is.
• Replace what they named with what they gave you, in the same slot. A term the merchant typed themselves is never overwritten by a candidate, however well it ranks.
• "Too generic" or "these are wrong" with nothing named is a request for a fresh set, not for a discussion — take the next candidates down the order and rewrite the piece on them; the review card shows the new set.

A keyword change means the piece is rewritten. The keywords are woven into the headings and the body, so a new set that is not written in is a lie about the piece. Re-enter the keywords node to settle the new set, then let the flow carry on to compose and produce the draft again from it — never edit the keyword line alone and hand back the old copy.