Your First Content Audit¶

This tutorial walks you through running your first AI-powered content audit from start to finish. By the end, you'll have a complete audit report with actionable recommendations.

Time Required

Setup: 5 minutes (if already installed)
Audit: 30-60 minutes
Review: 15-30 minutes

Prerequisites¶

Before starting, ensure you have:

Claude Code or OpenCode installed (Quickstart)
Seer Agent Engine plugins installed (Quickstart)
Connected to Seer MCP (Connect to Seer MCP) - recommended
A target URL to audit

No API keys needed!

Seer MCP is centralized. Just connect via OAuth with your Seer Google Account—no credentials to manage.

Stuck?

Running into issues? Check the Troubleshooting Guide or ask in #artificial-intelligence-gpt Slack.

Tutorial Map¶

flowchart LR
    A[Choose target page] --> B[Run command]
    B --> C[Answer intake]
    C --> D[Review output]
    D --> E[Share results]

Step 1: Choose Your Target Page¶

Select a page that would benefit from optimization. Good candidates include:

Pages with declining traffic (check Google Analytics)
Pages ranking on page 2 for target keywords
Important service/product pages that underperform
Older content that needs refreshing

For this tutorial, we'll use:

https://acme.com/blog/seo-best-practices

Replace this with your actual target URL.

Step 2: Start the Audit¶

Claude CodeOpenCode

Run the content audit command:

/seo:content-audit

Open your terminal in the agents-infra directory and launch OpenCode:

cd agents-infra
opencode

Then run the content audit command:

/content-audit

Step 3: Answer the Intake Questions¶

The agent will guide you through an intake process. Here's what to expect:

If you're stuck mid-flow

Run /utils:help or /utils:commands, or jump to Troubleshooting.

Question 1: Target URL¶

What URL would you like to audit?

Your answer: Paste your target URL

https://acme.com/blog/seo-best-practices

Question 2: Client Name¶

What is the client name? (Used for BigQuery data lookup)

Your answer: Enter the client name as it appears in your BigQuery organization

Example Corp

Question 3: Primary Goal¶

What is the primary goal of this audit?
- Traffic growth
- Conversion optimization  
- Competitive positioning

Your answer: Choose the most relevant goal

Traffic growth

Question 4: Target Keywords¶

What keywords are you targeting? (Or should I research them?)

Your answer: Provide keywords or request research

seo best practices, search engine optimization tips, seo guide 2024

Step 4: Watch the Agent Work¶

After intake, the agent executes the audit workflow:

Phase 1: Data Collection (5-10 minutes)¶

The agent gathers data from multiple sources:

📊 Collecting data...
├── BigQuery: Fetching current rankings
├── DataForSEO: Analyzing SERP landscape
└── Page Analysis: Extracting content structure

Phase 2: Analysis (10-15 minutes)¶

The agent analyzes the collected data:

🔍 Analyzing...
├── Keyword gaps identified: 12
├── Content opportunities: 5
├── Technical issues: 3
└── Competitive positioning: Moderate

Phase 3: Recommendations (10-15 minutes)¶

The agent generates prioritized recommendations:

📝 Generating recommendations...
├── High priority: 3 actions
├── Medium priority: 5 actions
└── Low priority: 4 actions

Step 5: Review the Output¶

The agent produces a structured audit report. Here's what to expect:

Executive Summary¶

## Executive Summary

**Page:** https://acme.com/blog/seo-best-practices
**Current Position:** Average rank 15 for target keywords
**Opportunity:** +35% organic traffic potential

### Key Findings
1. Missing H2 sections for "local SEO" and "mobile optimization"
2. Thin content in technical SEO section (320 words vs competitor avg 800)
3. No internal links to related service pages

Prioritized Recommendations¶

## Recommendations

### High Priority (Do First)

1. **Add Local SEO Section**
   - Current: Not present
   - Recommendation: Add 500-word section on local SEO best practices
   - Expected Impact: +15% traffic for local SEO keywords

2. **Expand Technical SEO Content**
   - Current: 320 words
   - Recommendation: Expand to 800+ words with examples
   - Expected Impact: +10% rankings improvement

Keyword Analysis¶

## Keyword Opportunities

| Keyword | Current Rank | Volume | Difficulty | Opportunity |
|---------|--------------|--------|------------|-------------|
| seo best practices | 12 | 5,400 | Medium | High |
| seo tips 2024 | 23 | 2,100 | Low | High |
| local seo guide | Not ranking | 1,800 | Medium | Medium |

Step 6: Take Action¶

Export to Wrike (Optional)¶

If you have Wrike connected, export recommendations as tasks:

Export these recommendations to Wrike as tasks

The agent creates tasks in your designated Wrike folder with:

Priority labels (High/Medium/Low)
Detailed descriptions
Expected impact notes

Export as CSV¶

If you prefer a spreadsheet:

Export recommendations as CSV

Manual Implementation¶

Copy the recommendations and add them to your content workflow:

Share with content team
Prioritize based on resource availability
Track progress in your project management tool

Common Questions¶

"What if BigQuery data is unavailable?"¶

The agent will ask you to provide data manually:

I couldn't access BigQuery. Can you provide:
1. Current rankings for this page (paste from Google Search Console)
2. Target keywords with search volumes

Paste the requested data and the audit continues.

"What if I don't know the target keywords?"¶

Tell the agent to research them:

Please research keywords for this page

The agent uses DataForSEO to find relevant keywords based on the page content and competitive landscape.

"How long does a full audit take?"¶

Phase	Time
Data Collection	5-10 minutes
Analysis	10-15 minutes
Recommendations	10-15 minutes
Total	30-60 minutes

Complex pages or large keyword sets may take longer.

"Can I audit multiple pages?"¶

Yes! Run multiple audits:

/content-audit

Repeat for each page. For bulk audits (10+ pages), consider the /search-landscape command instead.