Back to cookbook

AI Prompt to Audit Blog Content for SEO via HubSpot's MCP Server

0 views Updated

Make this prompt yours

Share

This HubSpot MCP prompt is for content marketers and SEO leads who want ChatGPT or Claude to pull live blog post data straight out of HubSpot and return a structured SEO audit — without exporting a CSV or copy-pasting post content by hand first. Once HubSpot's MCP server is connected to your AI client, the model can read a post's title, meta description, slug, word count, and topic cluster tags directly, then reason about what's actually hurting its search performance.

The prompt asks the model to check for the specific things that quietly tank organic traffic: a meta description that's missing or the wrong length, a title that doesn't match search intent, thin sections under target headers, and blog posts that have no internal links pointing to or from related cluster content. Because the data comes from the live HubSpot record rather than a stale export, the audit reflects what's actually published right now, which matters most for teams that update posts frequently.

This works well as a recurring check before a content calendar refresh, and it pairs naturally with tightening the audit instructions themselves — if the output feels too generic or keeps missing obvious gaps, running the prompt through Prompt Optimizer in Content mode is a reasonable next step to sharpen the constraints.

Prompt template

Make this prompt yours

prompt-template
299 tokens
ROLE: You are an SEO editor reviewing a blog post pulled from HubSpot via its MCP server. CONTEXT: - Post title: [POST_TITLE] - Post slug: [POST_SLUG] - Target keyword: [TARGET_KEYWORD] - Current meta description: [META_DESCRIPTION] - Word count: [WORD_COUNT] - Topic cluster / related posts: [RELATED_POST_TITLES] - Full post body (via HubSpot MCP read): [POST_BODY] TASK: Audit this post for on-page SEO issues using only the data above. Check specifically for: 1. Whether the title and meta description match the target keyword's search intent 2. Whether the meta description is within 120-160 characters and includes the target keyword 3. Header structure problems (missing H2/H3s, headers that don't match what the section actually covers) 4. Thin or underdeveloped sections relative to top-ranking content for this keyword 5. Missing internal links to or from the related posts listed above CONSTRAINTS: - Do not invent metrics, rankings, or competitor data you were not given - If a required field above is missing or empty, say so explicitly instead of guessing - Keep recommendations specific to this post, not generic SEO advice OUTPUT FORMAT: - A short summary verdict (Strong / Needs Work / Weak) - A prioritized list of 3-6 specific fixes, each one sentence - A separate line listing any internal link opportunities by post title

Want it sharper? Optimize this prompt with Prompt Optimizer, check it with the Prompt Debugger or shorten it with the Token Optimizer.

Example input

example-input
147 tokens
ROLE: You are an SEO editor reviewing a blog post pulled from HubSpot via its MCP server. CONTEXT: - Post title: 5 Ways to Reduce Cart Abandonment - Post slug: reduce-cart-abandonment - Target keyword: reduce cart abandonment - Current meta description: Tips to help your store. - Word count: 640 - Topic cluster / related posts: Checkout UX Best Practices, Email Recovery Flows for Ecommerce - Full post body (via HubSpot MCP read): [post body with 5 numbered tips, no H2 headers, each tip 1-2 sentences, no links to other posts] TASK: Audit this post for on-page SEO issues using only the data above...

When to use it

  • Running a quarterly SEO health check across an existing HubSpot blog
  • Triaging which old posts to update before a content refresh sprint
  • Reviewing a freshly drafted post in HubSpot before it goes live
  • Spotting internal linking gaps between posts in the same topic cluster

Best practices

  • Give the model the exact HubSpot MCP fields you want it to read (title, meta description, slug, body, tags) rather than letting it guess at post structure
  • Ask for a prioritized list of fixes, not just a list of problems, so the output is actionable
  • Cap the audit to one post per run at first so you can sanity-check the model's judgment before batching
  • Have the model flag when it lacks enough data from HubSpot to make a call, instead of inventing missing metrics

Common mistakes

  • Asking for a full-site audit in one prompt instead of auditing posts individually, which produces vague, generic feedback
  • Not specifying the target keyword, so the model guesses search intent instead of checking against the actual one
  • Treating word count alone as a quality signal instead of checking whether sections actually answer the query
  • Forgetting to ask for internal link suggestions, which is one of the easiest wins an MCP-connected audit can surface

FAQs

Can ChatGPT or Claude actually read my HubSpot blog posts directly?

Only if your AI client is connected to HubSpot's MCP server, which lets the model call HubSpot's API to read post fields like title, body, and meta description. Without that connection, you'd need to paste the content in manually, which this prompt also supports.

What's the difference between this and just asking an SEO checker tool?

A dedicated SEO tool scores against fixed rules and competitor data. This prompt uses the model's reasoning against your actual target keyword and cluster structure, which is better for judgment calls like "is this section thin" but won't replace rank-tracking data.

How often should I re-run an SEO audit on the same post?

Most teams see value re-auditing a post every 3-6 months or after a meaningful traffic drop, since search intent and competing content both shift over time.

Which Cuelara tool can help me tighten this audit prompt if the output feels too generic?

Prompt Optimizer — its Content mode is built for sharpening vague content-review instructions into the kind of specific, structured criteria this audit prompt depends on.

Found this prompt useful? Share it.

Share

More in Content & SEO

Content & SEO

AI Prompt to Turn a Blog Post Into a Twitter/X Thread

This AI prompt for repurposing a blog post into a Twitter/X thread is built for content marketers, bloggers, and solo creators who already h…

ROLE: You are a social media copywriter who specializes in turning long-form content into high-performing Twitter/X threads.

CONTEXT:
Source blog post or article: [PASTE FULL BLOG POST TEXT HERE]
Target audience: [DESCRIBE WHO WILL READ THIS THREAD]
Voice/tone to match: [E.G., CASUAL AND DIRECT / PROFESSIONAL AND AUTHORITATIVE]
Goal of the thread: [E.G., DRIVE CLICKS BACK TO THE FULL POST / STAND ALONE AS VALUABLE CONTENT]

TASK:
1. Identify the single most compelling hook, insight, or claim in the source content.
2. Generate 3-5 alternative opening tweets built around that hook, each using a different angle (question, bold claim, contrarian take, specific number/result).
3. Once the opening is chosen, break the rest of the article into a logical sequence of [NUMBER] tweets that build the argument step by step.
4. Write a closing tweet that includes a clear call to action: [E.G., LINK BACK TO FULL POST / ASK A QUESTION / INVITE REPLIES].

CONSTRAINTS:
- Each tweet must stay under 280 characters, including spaces and punctuation.
- Each tweet must make sense as a standalone statement, not require the previous tweet for context.
- Do not use hashtags unless explicitly requested.
- Match the specified voice and tone throughout, not just in the opening tweet.
- Number each tweet (1/, 2/, etc.) at the start.

OUTPUT FORMAT:
First, list the 3-5 candidate opening tweets under the heading "OPENING OPTIONS."
Then, under the heading "FULL THREAD," output the complete numbered thread starting from your recommended opening tweet through the closing call-to-action tweet.

Make this prompt yours

Content & SEO

SaaS Onboarding Email Sequence

This prompt writes a three email onboarding sequence built around one goal: getting a new user to their first win fast. Each email has a sin…

Write a 3-part email onboarding sequence for a B2B SaaS product called [PRODUCT], used by [AUDIENCE] to [MAIN OUTCOME].

Activation goal: [THE ONE ACTION THAT MATTERS]

Email 1: Welcome and quick win (send immediately).
Email 2: Discover the core feature (send day 2).
Email 3: Invite to the community or webinar (send day 4).

For each email give: 3 subject lines, preview text, body under 150 words, one call to action.
Tone: conversational, helpful, concise. No hype words.

Make this prompt yours

Content & SEO

High-Converting SEO Blog Post

A prompt for producing a first draft that is already structured for search . It fixes the word count, where the primary keyword must appear,…

Act as a top-tier SEO copywriter. Write a 1,500-word blog post.

Topic: [TOPIC]
Primary keyword: "[KEYWORD]"
Secondary keywords: [KEYWORD 2], [KEYWORD 3], [KEYWORD 4]
Audience: [WHO IS READING]
Search intent: [informational / how-to / comparison]

Constraints:
- Include the primary keyword in the H1 and at least two H2s.
- Keep paragraphs under 3 sentences.
- Use one bulleted list and one short FAQ section (3 questions).
- Do not invent statistics. Mark anything unverifiable with [VERIFY].
- End with a 155-character meta description labelled "Meta description:".

Make this prompt yours