Agent SEO Intent Analyst: Verify the Alignment Between Your Content and the SERP

At a glance

• What you'll do: Create a custom AI+ Agent that automatically analyzes whether your content matches the dominant search intent of the SERP for your focus keyword.
• Time required: ~5 minutes to set up, then a few seconds per analysis.
• Best for: SEO managers, content managers, and writers who want to understand why content isn't ranking despite strong optimization.

What is it for?

You've written high-quality, well-structured content with a solid optimization score… but it's struggling to reach the TOP 10? The issue might not be writing quality — it could be a misalignment between your content's intent and what Google expects for that keyword.

This AI+ Agent analyzes the SERP for your focus keyword, identifies the dominant search intent (informational, transactional, navigational, or commercial), then compares it to your content's actual intent. The result: a clear diagnosis and concrete recommendations to get back on track.

Good to know ℹ️: The four main search intents are: informational (the user is looking for an answer or explanation), transactional (they want to buy or take action), commercial (they're comparing before buying), and navigational (they're looking for a specific site or page). Informational content targeting a transactional keyword will have very little chance of ranking, and vice versa

What you'll get

The agent delivers a structured output in two parts:

1. 🔎 Intent Analysis : A 2–3 sentence diagnosis identifying the dominant SERP intent and your content's intent, then concluding on alignment (or misalignment).

2. 💡 Actionable Recommendations : Depending on the diagnosis:

• If alignment is confirmed: a quick action plan to improve your Content Score by integrating Semji's related terms and SEO questions.
• If a misalignment is detected, two paths are suggested:
  • Option A : Adapt your content: suggested structural changes to your title and headings (before/after format) to align your content with the dominant intent.
  • Option B : Change your keyword: 3 alternative keywords whose intent matches your current content.

Before you start

Make sure that:

• You have content open in the Semji editor with a focus keyword defined.
• SERP data is loaded for that keyword (SEO recommendations and competitor data must be available).
• You have access to the AI+ Agents feature (available depending on your Semji plan).

Tip ✅: Before running the agent, make sure your content in the editor is up to date. The agent analyzes the content as it appears in Semji, not the published version on your website.

How to do it 

1) Access AI+ Agents

From the Semji editor, open the content you want to analyze. Navigate to the AI+ Agents tab in the right-side panel.

2) Create the custom agent

Click Create a custom agent and configure it as follows:

• Name: SEO Intent Alignment (SERP vs Content)
• Instructions: Copy and paste the prompt below.
• Tools to enable:
  • ✅ Retrieve SEO recommendations
  • ✅ Get web page content
  • ✅ Google search

Main Objective: Analyze the Focus Keyword, associated SERP, and Client Content in the Semji editor to validate Search Intent alignment. Provide a clear diagnosis and actionable recommendations to optimize intent or target an alternative keyword.

Execution Steps:

1. Key Data Retrieval:
• Identify the Focus Keyword and the dominant Search Intent of the SERP from Semji's Competitors Insights and SERP title analysis (via the keyword_retrieve_serp tool if available and needed for current data).
• Analyze the client's current Title, Meta Description, and Editorial Structure/Content to determine the intent of their content.

2. Alignment Diagnosis:
• Compare the Dominant SERP Intent (e.g., transactional or informational) with the Client Content Intent.
• Assess whether the Client Content addresses the predominant intent Google expects for this keyword.

3. Recommendations (Conditional):

Case 1: Alignment Confirmed (Success):
• Validate the alignment.
• Propose a quick action plan to improve the Content Score by integrating Semji's Related Terms and SEO Questions.

Case 2: Misalignment Detected (Failure):
• Option A (Adapt Content): If the SERP is Transactional and the content is Informational (or vice versa), suggest structural changes and Title/H2 modifications to align the content with the dominant intent (e.g., add a "Pricing" or "Buy" section for transactional). Use agent_before_after_format to suggest changes to the Title and key H2s.
• Option B (Change Keyword): If the content cannot or should not be modified to match the SERP (e.g., incompatible editorial strategy), use the google:search tool (query like keywords "intent" [topic]) to find 3 alternative keywords whose intent matches the client content's current intent.

4. Response Format:
• Present the diagnosis in a "🔎 Intent Analysis" section (max 2-3 sentences).
• Present the recommendations in a "💡 Actionable Recommendations" section using bullet points.
• Use a professional, clear, results-oriented tone.

Agent Constraints:
• Priority: Use Semji data (Focus Keyword, Competitors Insights) before launching external tools.
• Tools: Use keyword_retrieve_serp to validate the current SERP, and google:search only for alternative keyword research in case of misalignment.
• Text Modification: Any text replacement suggestion (Title, Hx) must use the agent_before_after_format tool.

Click Create to save your agent.

3) Run the analysis

Once the agent is created, select it from your custom agents list and click on the Agent. The agent will start automatically:

1. Retrieve your focus keyword data and analyze the SERP using Semji's competitor data.
2. Analyze your content's title, meta description, and structure.
3. Compare both intents and produce its diagnosis.

4) Interpret the results

The agent returns a structured diagnosis. Here's how to read the two possible scenarios:

✅ Scenario 1 : Alignment confirmed

Your content's intent matches the dominant SERP intent. The agent then suggests an action plan to strengthen your ranking: integrate missing related terms, answer SEO questions identified by Semji, and improve your Content Score.

⚠️ Scenario 2 : Misalignment detected

Your content's intent doesn't match the SERP. The agent offers two paths:

• Option A : Adapt your content: concrete restructuring suggestions in a before/after format for the title and main headings. For example, transforming an informational guide into a comparison or purchase-oriented page.
• Option B : Change your keyword: if modifying your content isn't relevant to your editorial strategy, the agent searches for 3 alternative keywords whose intent matches your current content.

Concrete example

Situation: You've written a comprehensive guide titled "Everything You Need to Know About Compact Washing Machines" (informational content: technology comparisons, maintenance tips, capacity guide). Your focus keyword is "compact washing machine."

What the agent detects: The SERP for "compact washing machine" is 80% dominated by transactional pages (product listings, e-commerce category pages, price comparison sites). The dominant intent is clearly transactional.

Diagnosis: Misalignment : your informational content doesn't match the intent Google prioritizes for this keyword.

Agent recommendations:

• Option A: Restructure the content by adding purchase-oriented sections (price comparisons, best model selections, links to product pages). Before/after suggestions for the title and H2s.
• Option B: Target a more informational alternative keyword like "how to choose a compact washing machine," "compact washing machine buying guide," or "compact washing machine maintenance," whose SERPs match guide-type content.

Tip 💡: Systematically run this agent on content stuck outside the TOP 20 despite a strong optimization score. Intent misalignment is one of the most common — and most underestimated — causes of SEO underperformance.

Options and variations

You can customize the agent's prompt to fit your needs:

• Target a specific intent type: add an instruction for the agent to focus only on the informational/transactional distinction, if that's your main concern.
• Add industry context: specify your industry in the prompt so alternative keyword suggestions are more relevant (e.g., "We are an e-commerce company specializing in home appliances").
• Deepen competitive analysis: ask the agent to analyze the content of the top 3 SERP results to identify the specific structural elements matching the dominant intent.

Why is this useful?

Go further

Additional actions to consider:

• After correcting a misalignment, re-run the agent to confirm your content is now aligned.
• Combine this agent with the competitive content analysis agent to also identify missing topics.
• Integrate this intent check into your editorial workflow, ideally before publishing any new content.

Warning ⚠️: The dominant intent of a SERP can change over time. A keyword that was informational six months ago may become transactional if Google changes its interpretation. Re-run the analysis periodically, especially on your strategic content.

Useful links:

• [Create and configure a custom AI+ Agent]
• [Optimize existing content with Semji]