AccuRanker logo AccuRanker automation · runs weekly

Tag AccuRanker keywords in bulk

Your Tag Cloud is out of date: new pricing keywords have no tag, an old test tag is still on dozens of keywords, and the report that groups by tag shows the wrong numbers.

Cotlet does it in your own AccuRanker account with list_keywords, add_tags and remove_tags, called by your AI agent, an n8n workflow or a script.

Sign up free All AccuRanker tools

Hosted · nothing to install or maintain

Can AccuRanker do this on its own?

The official MCP can read tags with list_tags but cannot create, edit or delete them (checked 23 Oct 2026). The Write API pages name groups, domains and keywords, not tags. In the app, dynamic tags tag keywords by filter rules and are set up in the Tag Cloud, not from a list a colleague sends you.

How you do it in AccuRanker today

  1. Open the domain, go to the Keywords tab, click Add filter and choose Multiple Keywords, paste the list and click Add.
  2. Tick the keywords, click Edit, choose Add tags and pick the tags. You can also click Add Tag in the Tag Cloud and fill out the form.
  3. To tag from a file instead, download the CSV report from the keyword list, keep the 16 columns the guide names, write tags as tag1,tag2,tag3 and upload it from the Import menu.
  4. To remove a tag from one keyword, hover over the tag and click the small x. For several, select the keywords and choose Delete, then Remove Tags.
  5. None of this runs on its own: every new batch of keywords needs the same filter and click sequence again.

How to tag AccuRanker keywords in bulk

Prompt

In AccuRanker, find the keywords on Acme Outdoors whose landing page is under /pricing and tag them pricing-pages. Remove the tag q3-test from every keyword that still has it.
  1. 01

    Read the current tags

    Your agent calls list_tags first, so it reuses the spelling of tags that exist, such as pricing-pages, instead of creating pricing_pages next to it.

  2. 02

    Select the keywords

    list_keywords runs with the domain and returns the landing page URL of each row. The agent keeps rows whose landing page starts with /pricing and lists the ones with no landing page for you.

  3. 03

    Tag in one pass

    add_tags sends the keyword IDs and the tag names together, so a tag is not applied row by row. It adds static tags: they stay on the keywords until someone removes them.

  4. 04

    Remove the old tag

    For q3-test, the agent reads the keywords that carry it and calls remove_tags with their IDs. It removes the tag from those keywords only; the tag itself stays in the Tag Cloud until you delete it there.

  5. 05

    Leave dynamic tags alone

    remove_tags works on static tags only, as the x in the app does. When a tag in list_tags is dynamic, the agent reports it and leaves it, because AccuRanker removes it by itself once a keyword stops matching the filter.

What you get back

Example data

Domain: Acme Outdoors (48213)
Tagged pricing-pages: 23 keywords
No landing page, left for you: 2
Removed q3-test from 31 keywords
Skipped, dynamic tag: top-movers

Other ways to ask

  • Tag every keyword containing "alternative" with competitor-intent.
  • Tag the keywords from this pasted list with the campaign name, then show me the tag counts.
  • Remove the tag q3-test from all domains in the Clients group.
  • Every week, tag new keywords whose landing page is a blog post with content.

What AccuRanker allows, and what to know first

  • AccuRanker has two kinds of tags: a static tag stays on its keywords until you delete the tag or the keywords, and a dynamic tag follows filter rules and falls away when a keyword stops matching.
  • The small x on a tag in the keyword list works for static tags only.
  • Deleting a tag in the Tag Cloud removes it from all keywords; "Edit static tag" removes it from only some.
  • In the CSV import, changing anything besides tags creates duplicate keywords, so the guide says to keep all 16 columns and edit only Tags.
  • The guide gives no limit on tags per keyword and no naming rules, so the agent keeps names short and lowercase with hyphens.

add_tags and remove_tags change only your own AccuRanker data and reach no one else, so they run without asking first.

Sources: AccuRanker Help: Static tags and tagging keywords · AccuRanker Help: How to bulk add tags · AccuRanker Help: Dynamic Tagging · AccuRanker Help: MCP tool reference

Call add_tags from a script

curl

curl -X POST https://cotlet.dev/api/v1/accuranker/domains/48213/tags \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword_ids":["k_90311","k_90312","k_90340"],"tags":["pricing-pages"]}'

Example response

{
  "tagged_keywords": 3,
  "tags_applied": [
    "pricing-pages"
  ],
  "tag_type": "static"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is accuranker_write → add_tags. Example data.

Schedule it in n8n, Make, Zapier or cron

AccuRanker tools this automation uses

Cotlet AccuRanker tools used to tag AccuRanker keywords in bulk
Tool Parameters
list_keywords domain_id, search, tag, search_engine, cursor
add_tags domain_id, keyword_ids, tags
remove_tags domain_id, keyword_ids, tags
All 11 AccuRanker tools with descriptions

Frequently asked questions

Is it safe to connect AccuRanker to Cotlet?

Yes. You sign in to AccuRanker yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get AccuRanker once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

Give your agent access to AccuRanker.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with AccuRanker.

Sign up free