Agentic Platform
Documentation API reference Tools Skills

Tools

Search Console Keywords Groups

search_console_keywords_groups MCP Keywords

List the keyword groups configured on the current project.

List the keyword groups configured on the current project: id, name, slug, description, and match rules.

Playground

POST
item

No fields.

Credits

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Example
{}

Response

object
Properties
keyword_groups array required

Keyword groups configured on the project

Items: KeywordGroup

count integer required

Number of keyword groups returned

Example
{
  "keyword_groups": [
    {
      "id": 0,
      "name": "string",
      "slug": "string",
      "description": null,
      "values": [
        {
          "predicate": "eq",
          "value": "string"
        }
      ],
      "excluded_values": [
        {
          "predicate": "eq",
          "value": "string"
        }
      ]
    }
  ],
  "count": 0
}

Type Definitions

2 types

These are the available sub-object types that can be used in the properties above.

KeywordGroup object
#

One keyword group, reduced to the fields needed to filter Search Console.

id integer required

Keyword group id stored in keywords_groups_ids. Filter with the group id as a literal, for example `42 IN UNNEST(keywords_groups_ids)`.

name string required

Keyword group name

slug string required

Stable slug derived from the name

description string | null

Optional description of the keyword group

Default: null

values array required

Rules that include a keyword in the group

Items: KeywordGroupRule

excluded_values array required

Rules that exclude a keyword from the group

Items: KeywordGroupRule

KeywordGroupRule object
#

One match rule of a keyword group.

predicate string required

How the keyword is matched: eq, contains, or re

Values: eq contains re

value string required

Exact keyword, substring, or regular expression

Endpoints

POST http://agents.botify.com/{organization}/{project}/search_console_keywords_groups/process
POST http://agents.botify.com/{organization}/{project}/search_console_keywords_groups/batch_process
POST http://agents.botify.com/{organization}/{project}/search_console_keywords_groups/async_process
POST http://agents.botify.com/{organization}/{project}/search_console_keywords_groups/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/search_console_keywords_groups/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {}
}'

Over MCP

This tool is exposed as the MCP tool search_console_keywords_groups. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata