# Webflow SEO for AI agents

Webflow makes visual layout fast, yet CMS collection templates frequently ship truncated titles, skipped heading levels (`<h1>` straight to `<h4>`), client-injected scripts and missing structured data. Use clickd with Webflow’s MCP/Data API or Designer templates to audit and verify every page.

- Install skills: `npx skills add subinternal/clickd`
- Ask your agent: "Crawl our Webflow site with clickd_brief, list every CMS collection template failing title, heading or schema rules, and generate ready-to-paste dynamic JSON-LD."
- MCP tools used: `clickd_brief`, `clickd_pages`, `clickd_schema_create`, `clickd_rescan`

## What breaks most often on Webflow

- **Skipped headings used for font sizing** (`one-h1`): Designers pick `<h4>` or `<h5>` for visual label size above an `<h1>`, breaking semantic outline extraction for AI assistants.
- **Identical or overflowing CMS title formulas** (`title`): Collection templates using `{{Name}} | Long Tagline | Brand` push dozens of CMS items past 65 characters.
- **Missing or broken custom-code JSON-LD** (`structured-data`): Hand-pasted JSON-LD in Webflow Page Settings breaks when a CMS field contains quotes or newlines.

## The Webflow agentic SEO loop

1. **Read the published domain** (`clickd_brief`): Run clickd_brief and clickd_pages on your live Webflow domain to group every failing rule by CMS template.
2. **Fix collection fields & formulas** (`on-page-seo`): Update CMS item SEO fields via the Webflow Data API / MCP or tighten the collection template’s Title and Meta Description pattern.
3. **Generate validated JSON-LD** (`schema-markup`): Use clickd_schema_create to build clean Organization, Service, Article and FAQPage JSON-LD for Webflow’s Inside `<head>` slot.
4. **Publish & rescan** (`clickd_rescan`): Publish to your production domain in Webflow and run clickd_rescan to confirm zero broken JSON-LD blocks or heading skips.

## Worked pattern (Webflow CMS Collection Page -> Inside <head> tag)

Validate every custom-code JSON-LD block on the published URL with clickd_check (kind: "schema") so unescaped quotes never break parsing.

```
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to size a commercial heat pump",
  "datePublished": "2026-10-12",
  "author": { "@type": "Organization", "name": "Example Co", "url": "https://example.com" }
}
</script>
```

## Prompts to run on Webflow

- **Group Webflow issues by template**: "Run clickd_pages on example.com, group failing SEO rules by URL prefix (/blog/*, /services/*, /customers/*), and give me a template-by-template fix plan."
- **Generate Webflow head schema**: "Use clickd_schema_create on our main Webflow pages and validate the live published pages with clickd_check (kind: "schema")."
- **Audit AI crawler readability**: "Check our Webflow site with clickd_check (kind: "agent") and robots.txt rules to ensure GPTBot, ClaudeBot and PerplexityBot can read every CMS page."

## Paired skills

- [On-page SEO](https://clickd.com/skills/on-page-seo): Rewrites title tags, meta descriptions, single H1s, question headings, answer-first openings, image alt text and AI writing tells in your site’s templates and content files, checked live with clickd.
- [Schema markup](https://clickd.com/skills/schema-markup): Generates, wires and validates JSON-LD structured data (Organization, LocalBusiness, Product, Service, Article, FAQPage and BreadcrumbList) from the visible facts on your pages, checked live with clickd.
- [Technical SEO](https://clickd.com/skills/technical-seo): Audits and fixes crawlability, indexing, robots.txt, XML sitemaps, canonicals, redirect chains, server-rendered HTML and security headers in your site’s codebase, then checks every fix live with clickd.
- [AI visibility](https://clickd.com/skills/ai-visibility): Audits and fixes your site’s visibility in ChatGPT, Claude, Perplexity and Google AI Overviews: AI crawler access, non-JS HTML readability, answer-first passages, entity sameAs schema and live citation tracking.

## Questions

### Can an AI agent update Webflow CMS items directly?

Yes, if you connect Webflow’s Data API or MCP server alongside clickd MCP, your agent can update CMS item titles, slugs, descriptions and rich-text fields directly, then publish and verify with `clickd_rescan`.

### Why should we run `clickd_check` after pasting JSON-LD into Webflow?

Webflow injects CMS field strings directly into custom `<script>` blocks without JSON escaping, so a single double-quote inside a post title invalidates the entire JSON-LD block until caught on the live URL.