PACKAGE EXPLORERView in registry

adtech-crosswalk

PyPI

Cross-provider AdTech taxonomy mappings via MCP — the Context7 for AdTech

Versions collected1

Direct dependencies2From release 0.1.0

Last observed20 Oct, 19:55 UTC

README

Version 0.1.0 documentation

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

Type	Description
`ad_product`	Categories of advertised products
`audience`	Audience segment classifications
`content`	Content category classifications

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

Script	Purpose
`scripts/ingest/convert_iab_tsv.py`	Fetch IAB TSV → taxonomy.json
`scripts/ingest/convert_google_txt.py`	Fetch Google TXT → taxonomy.json
`scripts/validate.py`	Validate taxonomy.json and mapping.json schemas
`scripts/invert_mapping.py`	Generate reverse mapping from canonical

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

Tool	Description
`list_adtech_taxonomies`	Discover available providers, versions, and mapped pairs
`resolve_adtech_category`	Natural language → matching taxonomy entries (default: IAB, threshold: 0.75)
`get_adtech_mapping`	Category ID → cross-provider mappings, sorted by confidence

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, ... }] }

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.1.0	17 May 2026	2

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 19:55 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:0a7eaa00c0d1c595cd4549488b53dd4a9e9e1ed7a6c25c9620b1ef19430377b8