Skip to main content الرئيسية المنشئون neversight learn-skills.dev adcp-media-buy
adcp-media-buy Execute AdCP Media Buy Protocol operations with sales agents - discover advertising products, create and manage campaigns, sync creatives, and track delivery. Use when users want to buy advertising, create media buys, interact with ad sales agents, or test advertising APIs.
الانتقال إلى التثبيت سوق المهارات اكتشف واستكشف مهارات الذكاء الاصطناعي التي بناها المجتمع.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
عرض تفاصيل Prompt يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/NeverSight/learn-skills.dev --skill adcp-media-buyيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
تحميل Zip جاري التحميل... Search Argentine legal databases (SAIJ, JUBA, CSJN, JUSCABA) for jurisprudence, legislation, case summaries, and doctrine using the `ley` CLI. Use when the user asks about Argentine law, court decisions, legal precedents, fallos, jurisprudencia, legislación, or mentions SAIJ, JUBA, CSJN, JUSCABA. Supports parallel search across databases, JSON/table/text output, and filtering by jurisdiction. Built from reverse-engineered MCP servers (hernan-cc) — direct HTTP calls, no MCP layer needed.
المهن ذات الصلة SOC
استنادا إلى تصنيف SOC المهني
name adcp-media-buy description Execute AdCP Media Buy Protocol operations with sales agents - discover advertising products, create and manage campaigns, sync creatives, and track delivery. Use when users want to buy advertising, create media buys, interact with ad sales agents, or test advertising APIs.
AdCP Media Buy Protocol
This skill enables you to execute the AdCP Media Buy Protocol with sales agents. Use the standard MCP tools (get_products, create_media_buy, sync_creatives, etc.) exposed by the connected agent.
Overview
The Media Buy Protocol provides 8 standardized tasks for managing advertising campaigns:
Task Purpose Response Time get_productsDiscover inventory using natural language ~60s list_authorized_propertiesSee publisher properties ~1s list_creative_formatsView creative specifications ~1s create_media_buyCreate campaigns Minutes-Days update_media_buyModify campaigns Minutes-Days sync_creativesUpload creative assets Minutes-Days list_creativesQuery creative library ~1s get_media_buy_deliveryGet performance data ~60s
Typical Workflow
Discover products
get_products
Review formats : list_creative_formats to understand creative requirements
Create campaign : create_media_buy with selected products and budget
Upload creatives : sync_creatives to add creative assets
Monitor delivery : get_media_buy_delivery to track performance
Task Reference
get_products Discover advertising products using natural language briefs.
{
"brief" : "Looking for premium video inventory for a tech brand targeting developers" ,
"brand" : {
"domain" : "example.com"
} ,
"filters" : {
"channels" : [ "video" , "ctv" ] ,
"budget_range" : { "min" : 5000 , "max" : 50000 }
}
}
brief (string): Natural language description of campaign requirementsbrand (object): Brand identity - { "domain": "acmecorp.com" }filters (object, optional): Filter by channels, budget, delivery_type, format_types
products: Array of matching products with product_id, name, description, pricing_optionsEach product includes format_ids (supported creative formats) and targeting (available targeting)
list_authorized_properties Get the list of publisher properties this agent can sell.
publisher_domains: Array of domain strings the agent is authorized to sell
list_creative_formats View supported creative specifications.
{
"format_types" : [ "video" , "display" ]
}
format_types (array, optional): Filter to specific format categories
formats: Array of format specifications with dimensions, requirements, and asset schemas
create_media_buy Create an advertising campaign from selected products.
{
"buyer_ref" : "campaign-2024-q1-001" ,
"brand" : {
"domain" : "acme.com"
} ,
"packages" : [
{
"buyer_ref" : "pkg-video-001" ,
"product_id" : "premium_video_30s" ,
"pricing_option_id" : "cpm-standard" ,
"budget" : 10000
}
] ,
"start_time" : {
"type" : "asap"
} ,
"end_time" : "2024-03-31T23:59:59Z"
}
buyer_ref (string, required): Your unique identifier for this campaignbrand (object, required): Brand identity - { "domain": "acmecorp.com" }packages (array, required): Products to purchase, each with:
buyer_ref: Your identifier for this packageproduct_id: From get_products responsepricing_option_id: From product's pricing_optionsbudget: Amount in dollarsbid_price: Required for auction pricingtargeting_overlay: Additional targeting constraintscreative_ids or creatives: Creative assignments
start_time (object, required): { "type": "asap" } or { "type": "scheduled", "datetime": "..." }end_time (string, required): ISO 8601 datetime
media_buy_id: The created campaign identifierstatus: Current state (often pending for async approval)packages: Created packages with their IDs
update_media_buy Modify an existing campaign.
{
"media_buy_id" : "mb_abc123" ,
"updates" : {
"budget_change" : 5000 ,
"end_time" : "2024-04-30T23:59:59Z" ,
"status" : "paused"
}
}
media_buy_id (string, required): The campaign to updateupdates (object): Changes to apply - budget_change, end_time, status, targeting, etc.
sync_creatives Upload and manage creative assets.
{
"creatives" : [
{
"creative_id" : "hero_video_30s" ,
"name" : "Brand Hero Video" ,
"format_id" : {
"agent_url" : "https://creative.adcontextprotocol.org" ,
"id" : "video_standard_30s"
} ,
"assets" : {
"video" : {
"url" : "https://cdn.example.com/hero.mp4" ,
"width" : 1920 ,
"height" : 1080 ,
"duration_ms" : 30000
}
}
}
] ,
"assignments" : {
"hero_video_30s" : [ "pkg_001" , "pkg_002" ]
}
}
creatives (array, required): Creative assets to sync
creative_id: Your unique identifierformat_id: Object with agent_url and id from format specificationsassets: Asset content (video, image, html, etc.)
assignments (object, optional): Map creative_id to package IDsdry_run (boolean): Preview changes without applyingdelete_missing (boolean): Archive creatives not in this sync
list_creatives Query the creative library with filtering.
{
"filters" : {
"status" : [ "active" ] ,
"format_types" : [ "video" ]
} ,
"limit" : 20
}
get_media_buy_delivery Retrieve performance metrics for a campaign.
{
"media_buy_id" : "mb_abc123" ,
"granularity" : "daily" ,
"date_range" : {
"start" : "2024-01-01" ,
"end" : "2024-01-31"
}
}
delivery: Aggregated metrics (impressions, spend, clicks, etc.)by_package: Breakdown by packagetimeseries: Data points over time if granularity specified
Key Concepts
Brand identity Brand context is provided by domain reference:
{
"brand" : {
"domain" : "acmecorp.com"
}
}
The agent resolves the domain to retrieve the brand's identity (name, colors, guidelines, etc.) from its brand.json file.
Format IDs Creative format identifiers are structured objects:
{
"format_id" : {
"agent_url" : "https://creative.adcontextprotocol.org" ,
"id" : "display_300x250"
}
}
The agent_url specifies which creative agent defines the format. Use https://creative.adcontextprotocol.org for standard IAB formats.
Pricing Options Products include pricing_options array. Each option has:
pricing_option_id: Use this in create_media_buypricing_model: "cpm", "cpm-auction", "flat-fee", etc.price: Base price (for fixed pricing)floor: Minimum bid (for auction) For auction pricing, include bid_price in your package.
Asynchronous Operations Operations like create_media_buy and sync_creatives may require human approval. The response includes:
status: "pending" - Operation awaiting approvaltask_id - For tracking async progress Poll or use webhooks to check completion status.
Error Handling
400 Bad Request : Invalid parameters - check required fields401 Unauthorized : Invalid or missing authentication token404 Not Found : Invalid product_id, media_buy_id, or creative_id422 Validation Error : Schema validation failure - check field types {
"errors" : [
{
"code" : "VALIDATION_ERROR" ,
"message" : "budget must be greater than 0" ,
"field" : "packages[0].budget"
}
]
}
Testing Mode For testing without real transactions, agents may support:
X-Dry-Run: true header - Preview without side effectsTest products with test: true flag
Sandbox environments
Ask the agent about testing capabilities before creating real campaigns.
