Quickstart: Up and Running in 5 Minutes¶

Get from zero to your first AI-powered audit in under 5 minutes.

Prerequisites¶

Before you begin, you'll need:

Claude Code or OpenCode installed on your machine
Seer Google Account (for Seer MCP data access)

Need help fast?

Jump to Troubleshooting or FAQ.

New to terminal tools?

If you're on Windows and need to set up from scratch, see our Windows Setup Guide.

Windows quickstart

Start with the Windows Setup Guide before installing plugins.

No API keys needed!

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

Setup Tiers (Pick the Right Level)¶

Tier	What You Get	Who It's For
Tier 1: Methodologies only	Run commands with manual data input	Quick trials, training
Tier 2: BigQuery	Automated SEO/Analytics data	Most practitioners
Tier 3: DataForSEO	Real-time SERP data	SEO strategists
Tier 4: Wrike	Task automation + time tracking	Ops workflows

See the full definitions in the Glossary.

Step 1: Install Seer Agent Engine¶

Choose your preferred platform:

Claude CodeOpenCode (Power Users)

Install via the plugin marketplace:

Add our marketplace:

/plugin marketplace add seerinteractive/agents-infra

Install the plugins you need:

# Core dependencies (required)
/plugin install core-dependencies@seer-agent-core

# SEO workflows
/plugin install seo@seer-agent-core

# Optional: Paid Media workflows
/plugin install pdm@seer-agent-core

# Optional: Analytics workflows
/plugin install analytics@seer-agent-core

# Optional: Operations workflows (Wrike time tracking)
/plugin install operations@seer-agent-core

How plugin names work

Plugin commands are namespaced: /seo:content-audit. The marketplace name becomes part of the install path.

If installation fails¶

Re-run /plugin marketplace add seerinteractive/agents-infra
Restart Claude Code and try again
Run /plugin list to confirm installs

Installation not working?

Issue	Solution
"Marketplace not found"	Run `/plugin marketplace add seerinteractive/agents-infra` first
"Plugin install fails"	Check internet connection, restart Claude Code
"Commands not appearing"	Restart session after installation

See Troubleshooting for more help.

OpenCode is a multi-provider alternative that can use Claude, ChatGPT, or other models. It natively reads Claude Code plugins.

Option A: Use Claude Code plugins directly

If you've already installed plugins via Claude Code, OpenCode will automatically discover them.

opencode

Option B: Clone the repository

For development or customization:

git clone https://github.com/seerinteractive/agents-infra.git
cd agents-infra
opencode

OpenCode will auto-discover plugins in plugins/divisions/.

OpenCode not finding plugins?

Issue	Solution
Plugins not auto-discovered	Verify `plugins/` directory exists in project root
Config not loading	Check `.opencode/config.json` syntax (valid JSON)
MCP connection failing	See Step 2 for Seer MCP setup

See Troubleshooting for more help.

Step 2 (Optional): Connect to Seer MCP¶

Seer MCP provides access to BigQuery data, workflows, and AI tools—all through a single OAuth connection.

If you want to start without MCP, you can. Commands will prompt for manual data instead.

See Configure MCP Servers for the full setup guide.

For Claude (Web/Desktop)¶

Open Claude at claude.ai
Use the web browser for initial setup
Access Connectors
Click the + (Plus) icon in the bottom-left
Select Connectors → Manage Connectors
Connect to SEERMCP
Find and click SEERMCP
Click Connect
Authenticate
Sign in with your Seer Google Account
Authorize all requested permissions
Start a new conversation to load the tools

For OpenCode / Claude Code CLI¶

Add to your MCP configuration (~/.claude/.mcp.json):

{
  "mcpServers": {
    "seer-mcp": {
      "url": "https://seer-mcp.run.app",
      "auth": {
        "type": "oauth",
        "provider": "seer"
      }
    }
  }
}

What is an environment variable?

An environment variable is a key/value stored in your shell (e.g., export FOO=bar). You do not need env vars for Seer MCP OAuth, only for local MCP servers.

What you get access to

BigQuery/SeerSignals - 2+ years of paid media, SEO, CRM data
Workflow Library - Pre-built deterministic processes
Wil's Presentations - Search and retrieve presentation content
AI Search Volume - DataForSEO AI search data

Step 3: Discover Available Commands¶

See what's available:

Claude CodeOpenCode

/seo:utils:commands

/utils:commands

You'll see something like:

Available Commands:
├── SEO Division
│   ├── /content-audit      - Optimize existing pages
│   ├── /content-outline    - Blueprint for new pages
│   └── /search-landscape   - Comprehensive SERP analysis
└── Utilities
    ├── /utils:help         - Get help
    └── /utils:commands     - List all commands

Don't know which skill to use?

Ask "what skills are available?" or "prime my session for [task]" to discover the right skills for your work. The seer-skill-primer skill will help you navigate the entire Seer skill ecosystem.

Claude.ai users: If the Seer MCP is connected, Claude can call seer_skill_primer_mcp() to automatically recommend skills.

Step 4: Run Your First Audit¶

Let's run a content audit:

Claude CodeOpenCode

/seo:content-audit

/content-audit

Last updated: 2026-01-26

The AI will guide you through:

Intake - Asking about the target URL, client, and goals
Data Plan - Determining what data to gather
Analysis - Finding insights and opportunities
Draft - Creating your deliverable
Polish - Applying Seer standards and QA

Expected Time

30-60 minutes for a complete content audit (vs. 3 hours manually)

What's Next?¶

Explore Workflows

See all available commands and when to use each one.

SEO Workflows
Best Practices

Tips for getting the best results from AI-powered workflows.

Best Practices
Use Cases

Real-world scenarios showing how different roles use the system.

Use Cases
Architecture

Understand how the system works under the hood.

Architecture

Troubleshooting¶

Plugin not found?¶

Make sure you've added the marketplace first:

/plugin marketplace add seerinteractive/agents-infra

Command not found?¶

In Claude Code, commands are namespaced by plugin. Use the full name:

# Wrong
/content-audit

# Right
/seo:content-audit

Seer MCP not connecting?¶

Issue	Solution
"Connector not appearing"	Refresh page; ensure you're in Seer Team workspace
"Authorization fails"	Clear browser cache; try incognito mode
"Tools not working"	Start a new conversation after connecting

See the full Troubleshooting Guide for more help.

Working Without Seer MCP¶

All commands work even without Seer MCP connected:

Command	With Seer MCP	Without Seer MCP
`/content-audit`	Auto-fetch rankings from BigQuery	Manual CSV/data input
`/search-landscape`	Auto-fetch SERP data	Manual competitor analysis
`/time-tracking`	Sync with Wrike	Export to clipboard

The agent will guide you through providing data manually if needed.