create_keyword_cluster
writeKeyword Research & Management
Create a keyword cluster with grouped keywords.
Write tool
Mutates Rampify state, triggers background work, or calls a paid external API. Most clients ask for confirmation before invoking.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| domain | string | optional | Site domain |
| project_id | string | optional | Project UUID |
| name | string | required | Cluster name |
| description | string | optional | Strategic rationale |
| priority | enum("critical" | "high" | "normal" | "low") | optional | Cluster priority |
| competitive_landscape | string | optional | What currently ranks, competitors, positioning gaps |
| notes | string | optional | Free-form strategic notes |
| target_content_type | string | optional | Content type: blog_post, landing_page, guide, authority_page, tool_page, feature_page |
| target_url | string | optional | Proposed SEO-optimized URL path. Always propose a URL based on the primary keyword and content type. |
| keywords | string | object[] | optional | Keywords to assign. Accepts strings (default secondary) or {keyword, tier} objects. New keywords are auto-created. |
| primary_keyword | string | optional | The head term — set as primary tier. Others default to secondary. |