Skip to content

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:

  • OpenCode or Claude Code installed on your machine
  • API credentials for data sources (optional but recommended):
    • BigQuery project ID (for ranking/traffic data)
    • DataForSEO API key (for SERP/keyword data)
    • Wrike API token (for task export)

New to terminal tools?

If you're on Windows and need to set up Node.js, Claude Code, Gemini, or Codex from scratch, see our Windows Setup Guide.

Don't have credentials yet?

You can still run workflows! Commands gracefully degrade to manual input when data sources aren't available.

Step 1: Clone the Repository

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

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

Step 2: Configure Your Environment

Set up your data source credentials:

# Required for BigQuery data
export BIGQUERY_PROJECT_ID="your-project-id"

# Required for keyword/SERP data
export DATAFORSEO_API_KEY="your-api-key"

# Optional: for Wrike task export
export WRIKE_API_TOKEN="your-token"

Where to get these credentials

  • BigQuery: Contact your Analytics team for project access
  • DataForSEO: Sign up at dataforseo.com
  • Wrike: Generate a token in Wrike Settings → API

Step 3: Launch OpenCode

Start OpenCode in the project directory:

opencode

OpenCode will automatically discover the plugins in plugins/divisions/.

Step 4: Discover Available Commands

See what's available:

/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

Step 5: Run Your First Audit

Let's run a content audit:

/content-audit

The AI will guide you through:

  1. Intake - Asking about the target URL, client, and goals
  2. Data Plan - Determining what data to gather
  3. Analysis - Finding insights and opportunities
  4. Draft - Creating your deliverable
  5. 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.

    Workflows Guide

  • 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

Command not found?

Make sure you're in the agents-infra directory and OpenCode has loaded the plugins:

cd agents-infra
opencode

MCP connection errors?

Check that your environment variables are set correctly:

echo $BIGQUERY_PROJECT_ID
echo $DATAFORSEO_API_KEY

See the full Troubleshooting Guide for more help.