adtech-crosswalk

Open-source AdTech agent toolkit — cross-provider taxonomy mappings, conversion utilities, and LLM-assisted tooling for the advertising technology ecosystem.

Taxonomy Mappings

Bidirectional mappings between AdTech category taxonomies from industry bodies and major platforms.

Taxonomy Types

Structure

taxonomies/{taxonomy_type}/{provider}/{version}/taxonomy.json
mappings/{taxonomy_type}/{source}__{target}/mapping.json

Provider version conventions:

• IAB Tech Lab: v1.0, v2.0 (immutable snapshots)
• Google: latest (single folder, snapshot_date in metadata)

Mappings

Mapping folders use double-underscore to separate source from target: iab_v2.0__google_latest = IAB Ad Product 2.0 → Google Product Type (latest)

Each mapping pair has a canonical file (source of truth, indexed by the provider with stable integer IDs) and a derived reverse file (auto-generated, never edited directly).

Discovery

index.json at the repo root lists all registered providers, taxonomies, and mappings. LLM agents should read index.json first to discover available paths.

Scripts

Sources

• IAB Tech Lab Taxonomies: https://github.com/InteractiveAdvertisingBureau/Taxonomies
• Google Product Type Taxonomy: https://www.google.com/basepages/producttype/taxonomy.en-US.txt

MCP Server

adtech-crosswalk is available as an MCP server for any LLM agent that supports the Model Context Protocol.

Install

# Run directly with uvx (no install required)
uvx adtech-crosswalk

# Or install globally
pip install adtech-crosswalk

Configure

Add to your MCP client config (Claude Code, Cursor, Copilot, etc.):

{
  "mcpServers": {
    "adtech-crosswalk": {
      "command": "uvx",
      "args": ["adtech-crosswalk"]
    }
  }
}

Tools

Example

# Step 1 — discover
list_adtech_taxonomies()

# Step 2 — find the right category
resolve_adtech_category(raw_category="craft beer", providers=["iab"], version="v2.0")
→ { matches: [{ category_id: "1004", category_name: "Beer", relevance_score: 0.91 }] }

# Step 3 — get cross-provider mappings
get_adtech_mapping(provider="iab", version="v2.0", category_id="1004")
→ { source: {...}, mappings: [{ target_provider: "google", confidence: 0.95, ... }] }