How do I connect a Grok bot (or any 24/7 bot) to SEOBetter?

A bot that runs on its own, such as a Grok agent on a server, connects to your WordPress site with one bot key. You don't need a username, an Application Password or a desktop app.

What you need

  • SEOBetter Pro, Pro+ or Agency, active on the site
  • WordPress 6.9 or newer, on HTTPS
  • The SEOBetter Agent add-on 0.4.2 or newer, and the free WordPress MCP Adapter
  • A WordPress user for the bot with the Editor or Author role. We suggest a separate user just for the bot: Users, then Add New. Pick Editor, or Author if the bot should only touch its own posts. A bot key cannot act as an administrator (see "Why does my bot key need an Editor or Author user?").

Step by step

  1. In WordPress, open SEOBetter, then Settings. In the AI assistants (MCP) box, install the SEOBetter Agent add-on and the free MCP Adapter.
  2. Open SEOBetter, then AI bot access. The three checks at the top should all show a tick: HTTPS, licence and MCP Adapter.
  3. Under Create a bot key, fill in:
    • Name: for example "Grok bot".
    • Acts as user: choose the bot's Editor or Author. Only Editors and Authors are listed, and nothing is picked for you. The bot does what this user can do, and its posts are credited to this user.
    • Articles per day: how many new articles the bot may start each day.
    • Product writes per day: how many products SEOBetter may write for the bot each day (write a product, create a product with SEOBetter writing its copy, and each such row of a bulk batch). 50 by default, up to 2,000. They do not count against Articles per day. Each write still counts against your plan's monthly SEOBetter Cloud allowance, or your own AI key.
    • Keyword research calls per day: each call spends on your DataForSEO account.
    • Mode: start with Drafts only.
    • Site-wide tools: tick what the bot needs. Site insights and Keyword research are on for a new key, and the ready-made routines need both. See "What a bot key can use" below.
  4. Click Create key. Copy the key now; it is shown once.
  5. Copy the Grok block into the tools list your bot sends to the xAI API. It contains your site's MCP address and the key.
  6. Any other bot: give it the MCP server URL and the header Authorization: Bearer followed by the key.

Check it worked

Back on AI bot access, the key's Last used time updates when the bot connects. The Today column counts articles, product writes, research calls, post edits and deletes. The bot can read its own limits and what it has used today from get-site-context (the bot_key part).

Drafts only and Publish

In Drafts only, the bot can research, write and save drafts, and create draft products. It cannot publish, schedule, trash or change posts or products that are already live. Read its drafts for a week, then switch the key to Publish in the key list.

Built-in limits

  • No raw HTML. While a bot key is signed in, it can never save scripts or other unsafe markup. WordPress strips them from everything the bot writes, whatever the user's role.
  • Product writes. Each product SEOBetter writes for the bot counts against Product writes per day (50 by default, up to 2,000), never against Articles per day. On top of the daily limit, product creates and product writes are each limited to 500 an hour per user.
  • Post edits. Fixes, optimise, refresh and rewrites of a post or page count against Post edits per day (50 by default).
  • Deletes. Every delete counts against its own allowance of 5 a day per key. You can still delete as much as you like from wp-admin.

What a bot key can use

The bot can do what its Editor or Author can do with posts. Tools that work on the whole site, and the product tools, are opened per key with the Site-wide tools checkboxes (Agent 0.4.2 and newer). The bot's user never becomes an administrator: a ticked box only lets the key use that group of tools, one call at a time.

  • Site insights (on for a new key): the site context, the to-do list, site traffic, stale posts, cannibalisation and the site audit. Read only.
  • Keyword research (on for a new key): research and cluster keywords, within the key's Keyword research calls per day.
  • Brand voice and settings (off): read and change brand voices and the writing settings. A Drafts only key can read them but not change them.
  • Bulk batches (off): start a bulk batch. Each item counts as one article per day, and a batch publishes on its own only in Publish mode and only if the bot's user can publish.
  • Products (off): find, create, write, score and optimise WooCommerce products, and rewrite their name, slug and descriptions. Rewrites never touch price, stock or status, new products are drafts unless the key is in Publish mode, and nothing is ever deleted. Creating products needs SEOBetter Pro 2.0.13 and Agent 0.5.0 or newer; see "How do I let my AI agent create WooCommerce products?".

You can change the boxes any time in the key list, then click Save.

Older keys that act as an administrator

Keys created before Agent 0.4.1 that act as an administrator keep working, but they can no longer save raw HTML either. A key created before Agent 0.4.2 has its boxes chosen for it (SEOBetter Agent 0.4.3 and newer): all five if the bot's user is an administrator, otherwise only Site insights and Keyword research. Save the key's row once to set its boxes yourself. The key list shows them with a red warning. We recommend creating a new key for an Editor or Author and revoking the old one.

Stop or remove a bot

To stop a bot, click Revoke next to its key. It can no longer connect. Uninstalling the SEOBetter Agent add-on deletes every bot key.

Related articles