add_keyword_research_terms
Add selected terms from a completed saved search to one topic. Read get_keyword_research for run_id and exact terms, and get_search_workspace section monitoring for revision and topic ids. Give topic_id, or new_topic_name to create a topic. Terms must come from the monitored country and language. When the topic is active and the monitoring section’s tracking_active is true, the terms are tracked at once: each new term costs weekly_term_usd per week, so confirm the added cost with the user first. A draft topic only saves them until it is published; a new topic is active when the website already tracks topics. Deduplicates; 100-term cap. Stale revisions fail; reread before retry. Returns revision, active_revision, topic_status, term_count (tracked searches) and tracking_active (true: these terms are bought from this week).
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
site_source_id | string | yes | ||
run_id | string | yes | ||
terms | array | yes | ||
revision | integer | yes | ||
topic_id | string | no | ||
new_topic_name | string | no |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.