• DUPLICATES
  • GAPS
  • LOGIC
  • HUMAN

How to audit content taxonomy with your AI

Connect ButterCMS to your agent to pull your entire organizational structure into a single chat session. Once connected, your AI identifies the gaps and overlaps in your metadata.

Ask AI about this page

Short answer

How can I audit my content taxonomy with AI?

Your AI pulls your existing categories, tags, and authors to look for duplicates, typos, or logical inconsistencies. You get a clean list of structural issues to fix. This breakdown shows you how to run the audit.

Audit outcomes

Where your audit results land.

The AI categorizes findings based on how much manual work you need to do next.

DUPLICATES

Identified redundant tags

The AI finds identical or near-identical tags and categories. You get a list of what to merge to clean up your CMS.

GAPS

Missing organizational links

The agent spots authors without categories or tags that don't map to any content. This highlights where your structure is broken.

LOGIC

Taxonomy drift detection

The AI flags categories that no longer make sense given your current tag distribution. It points out where your hierarchy is getting messy.

HUMAN

Manual cleanup required

The AI identifies the specific items that need your eyes. It won't change your CMS settings, so you decide what to delete or rename.

The workflow

What your AI does when the audit starts.

The AI moves through your CMS data to build a map of your content structure.

  1. Map categories

    The agent pulls every category currently defined in your ButterCMS instance.

    list_butter_categories

  2. Pull tag data

    The AI gathers all existing tags to compare them against your category list.

    list_butter_tags

  3. Check author assignments

    The agent looks at your author list to see how they relate to your content structure.

    list_butter_authors

  4. Analyze inconsistencies

    The AI compares all three data sets to find the specific errors in your taxonomy.

    list_butter_categorieslist_butter_tagslist_butter_authors

Try it

Copy these to start.

Use these prompts to kick off your audit.

Starting points

These are opening lines. Swap the specific category or tag names to target a certain area of your site.

ButterCMS Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ButterCMS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "buttercms-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/mcp"
    }
  }
}
Copy into chat04

  • List all my ButterCMS categories and tell me if any look like duplicates.

  • Compare my tags to my categories and find any tags that don't belong to a category.

  • Check my list of authors and tell me if any are missing assigned categories.

  • Review all my tags and find any spelling inconsistencies or overlapping terms.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect ButterCMS once, then ask.

Just link your account through Vinkius. Your credentials stay encrypted, and you can start auditing immediately in your preferred AI client.

Connect ButterCMS to your AI

FAQ

How the audit behaves

  • 01

    Can the AI delete my categories or tags?

    No. The AI only reads your data. You have to go into ButterCMS to make any actual changes.

  • 02

    Will this change my site's structure automatically?

    No. The AI identifies the issues and provides the analysis, but it cannot modify your CMS settings.

  • 03

    Can I audit specific tags instead of everything?

    Yes. You can ask the AI to focus its analysis on a specific subset of tags or categories.

  • 04

    Does the AI see my actual content text?

    No. This specific task only looks at the metadata like categories, tags, and authors.

  • 05

    How does the AI find duplicates?

    It compares the strings in your category and tag lists to find near-matches or identical names.

  • More questions about ButterCMS? See everything the ButterCMS Connector can do

Connect ButterCMS to Claude, Cursor, ChatGPT & more