{"id":"keywords_clustering","name":"Keywords Clustering","alias":"KeywordsClustering","aliases":[],"description_short":"Cluster keywords into groups.","description_long":"\n    This tool groups keywords provided by @KeywordsSuggestions or @KeywordsSuggestionsGoogleAdsPlanner into thematic clusters based on user intent and behavior.\n    The clustering reveals content opportunities by combining related terms, considering search volume, competition, and commercial intent.\n    These clusters inform content strategy by highlighting topic hierarchies, gaps, and potential site structure improvements.\n    Each cluster includes a relevance assessment to guide content prioritization.\n    ","description_tool_prompt":"Analyze and organize keywords into meaningful, thematic clusters that reflect user search intent and behavioral patterns. This advanced clustering process helps identify content opportunities by grouping semantically related search terms, considering factors like search volume, competition, and commercial intent.\n\nThe clusters enable strategic content planning by revealing topic hierarchies, content gaps, and potential site structure improvements. Each cluster includes a detailed rationale and relevance assessment based on your website's context, making it easier to prioritize content creation and optimization efforts.\n\nKeywords must be provided by **@KeywordsSuggestions** or **@KeywordsSuggestionsGoogleAdsPlanner**","source":null,"conversation_examples":["Do a keywords clustering for related keywords to 'best electric toothbrush'","Do a keyword research for 'sustainable fashion' with Google Ads Planner and then cluster them"],"tags":["keywords"],"available_in_chat":true,"available_in_deepthink":true,"available_in_mcp":false,"mcp_audience":"all","config":{"type":"object","properties":{"location_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Location ID (optional)","title":"Location Id"},"location_request":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Location request (ex: Paris, FR), will translate to location ID","title":"Location Request"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO3166 country code (ex: GB)","title":"Country Code"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"BCP47 language code (ex: \"en\", \"en-GB\")","title":"Lang Code"},"device":{"default":"mobile","description":"Device to use for search (optional - defaults to mobile)","enum":["mobile","desktop"],"title":"Device","type":"string"}},"required":[]},"item":{"type":"object","properties":{"tool_origin":{"description":"Tool origin to get keywords from","enum":["keywords_suggestions","keywords_suggestions_google_ads_planner"],"title":"Tool Origin","type":"string"},"language":{"default":"en","description":"Target language for clusters","title":"Language","type":"string"},"keywords":{"description":"List of keywords to cluster","items":{"type":"string"},"maxItems":20,"title":"Keywords","type":"array"}},"required":["tool_origin","keywords"]},"response":{"$defs":{"KeywordsCluster":{"properties":{"name":{"description":"Name of the keywords cluster","title":"Name","type":"string"},"main_keyword":{"description":"The main keyword representing the cluster","title":"Main Keyword","type":"string"},"keywords":{"description":"List of keywords belonging to this cluster","items":{"type":"string"},"title":"Keywords","type":"array"},"rationale":{"description":"Explanation of why these keywords are grouped together","title":"Rationale","type":"string"},"relevant_for_website":{"description":"Whether this cluster is relevant for the website based on its description","title":"Relevant For Website","type":"boolean"}},"required":["name","main_keyword","keywords","rationale","relevant_for_website"],"title":"KeywordsCluster","type":"object"}},"properties":{"clusters":{"description":"List of keyword clusters","items":{"$ref":"#/$defs/KeywordsCluster"},"title":"Clusters","type":"array"},"website_description_used_for_clustering":{"description":"The website description that was used to assess cluster relevance","title":"Website Description Used For Clustering","type":"string"},"website_description_used_for_clustering__notes":{"description":"Notes about the website description used for clustering","title":"Website Description Used For Clustering  Notes","type":"string"}},"required":["clusters","website_description_used_for_clustering","website_description_used_for_clustering__notes"],"title":"KeywordsClusteringProcessedItem","type":"object"},"has_canvas":true,"open_canvas_automatically":false}