Skip to content

Publisher Setup Guide

Step-by-step guide for publishers deploying the IAB Tech Lab Seller Agent.

Setup Checklist

  1. Configuration & Environment -- Set env vars, connect your ad server
  2. Inventory Sync -- Connect GAM/FreeWheel, sync your inventory
  3. Media Kit -- Set up your inventory catalog with packages, tiers, and featured items
  4. Pricing & Access Tiers -- Configure buyer pricing tiers, discounts, negotiation limits
  5. Approval & Human-in-the-Loop -- Set up approval gates for deals
  6. Buyer & Agent Management -- Manage API keys, agent trust, buyer access

Current Status

Alpha Release

The seller agent is in active development. Some configuration is done via environment variables and code-level defaults rather than runtime APIs. This guide documents what works today and notes planned improvements. See PROGRESS.md for current roadmap status.

Prerequisites

Before starting, ensure you have:

  • Python 3.11+ installed
  • An Anthropic API key (ANTHROPIC_API_KEY) for the LLM-powered specialist agents
  • (Optional) A Google Ad Manager network code and service account key for live inventory sync
  • (Optional) A public URL for agent discovery if participating in the IAB AAMP ecosystem

Architecture Overview

The seller agent runs as a FastAPI service that exposes:

  • REST API for buyer agents and operators
  • MCP and A2A protocol interfaces for agent-to-agent communication
  • OpenDirect 2.1 compliance for deal lifecycle management
  • Human-in-the-loop approval gates for operator oversight
graph LR
    BuyerAgent[Buyer Agent] -->|REST / A2A| SellerAPI[Seller API]
    Operator[Publisher Operator] -->|REST| SellerAPI
    SellerAPI --> Crew[CrewAI Agents]
    SellerAPI --> GAM[Google Ad Manager]
    SellerAPI --> Storage[(SQLite / Redis)]
    SellerAPI --> Registry[AAMP Registry]