How iabtechlab/seller-agent works
Seller Agent is a publisher/SSP platform for inventory discovery, tiered pricing, AI-assisted negotiation, deal booking and distribution. Buyers and operators enter through MCP, REST, A2A or chat; the platform exposes a tiered media kit, prices and negotiates proposals, then manages deal and order lifecycles and connects to ad servers, SSPs and buyer deal APIs. The README documents the overall architecture and integrations; sampled source confirms several service, engine and storage responsibilities, but not every runtime connection.
Main entry points: deal_service.py Deal lifecycle · catalog_service.py Inventory catalog · main.py REST API · mcp_server.py MCP tools
Components 19
Access interfaces
- MCP tools
src/ad_seller/interfaces/mcp_server.py - REST API
src/ad_seller/interfaces/api/main.py - Buyer chat
src/ad_seller/interfaces/chat/main.py - A2A interface
src/ad_seller/clients/a2a_client.py
Inventory and commerce
- Inventory catalog
src/ad_seller/services/catalog_service.py - Tiered media kit
src/ad_seller/engines/media_kit_service.py - Tiered pricing
src/ad_seller/engines/pricing_rules_engine.py - Negotiation engine
src/ad_seller/engines/negotiation_engine.py - Agent hierarchy
src/ad_seller/agents/level1/inventory_manager.py - Buyer identity tiers
src/ad_seller/models/buyer_identity.py
Deal operations
- Deal lifecycle
src/ad_seller/services/deal_service.py - Order management
src/ad_seller/services/order_service.py - Approval gates
src/ad_seller/events/approval.py - Event bus
src/ad_seller/events/bus.py
Persistence and integrations
- Storage backend
src/ad_seller/storage/base.py - Ad server adapters
src/ad_seller/clients/ad_server_base.py - SSP connectors
src/ad_seller/clients/ssp_base.py - Buyer deal sync
src/ad_seller/clients/deal_sync_base.py
Other components
- Buyers and operators
Connections 26
- Buyers and operators → MCP tools: use tools
README.md - Buyers and operators → REST API: call endpoints
README.md - Buyers and operators → Buyer chat: start conversations
README.md - Buyers and operators → A2A interface: send queries
README.md - REST API → MCP tools: mounts protocol
src/ad_seller/interfaces/api/main.py - MCP tools → Inventory catalog: manage inventory
src/ad_seller/interfaces/mcp_server.py - REST API → Inventory catalog: serves catalog
src/ad_seller/interfaces/api/main.py - Buyer chat → Inventory catalog: reads products
src/ad_seller/interfaces/chat/main.py - Inventory catalog → Tiered media kit: exposes inventory
README.md - Tiered media kit → Tiered pricing: applies tier access
src/ad_seller/engines/media_kit_service.py - Buyer identity tiers → Tiered pricing: sets buyer tier
src/ad_seller/engines/pricing_rules_engine.py - Agent hierarchy → Tiered pricing: evaluates offers
README.md - Agent hierarchy → Negotiation engine: negotiate proposals
README.md - Buyer chat → Negotiation engine: evaluates offers
src/ad_seller/interfaces/chat/main.py - Negotiation engine → Tiered pricing: gets tier price
src/ad_seller/engines/negotiation_engine.py - REST API → Deal lifecycle: routes deal actions
src/ad_seller/interfaces/api/main.py - MCP tools → Deal lifecycle: manages deals
src/ad_seller/interfaces/mcp_server.py - Deal lifecycle → Order management: books orders
README.md - Deal lifecycle → Approval gates: requests approval
README.md - Approval gates → Event bus: emits decisions
src/ad_seller/events/approval.py - Deal lifecycle → Event bus: publishes lifecycle
src/ad_seller/services/deal_service.py - Inventory catalog → Storage backend: reads and writes
src/ad_seller/services/catalog_service.py - Deal lifecycle → Storage backend: persists deals
src/ad_seller/services/deal_service.py - Deal lifecycle → Ad server adapters: activates deals
README.md - Deal lifecycle → SSP connectors: distributes deals
README.md - Deal lifecycle → Buyer deal sync: pushes to buyers
README.md