Добавить сервер
mikusnuz/meta-ads-mcp
  1. Каталог MCP
  2. mikusnuz/meta-ads-mcp

mikusnuz/meta-ads-mcp

от mikusnuz
MCP-сервер для Meta Marketing API предлагает 135 инструментов для управления рекламными кампаниями Facebook и Instagram: от создания объявлений до аналитики и каталогов. Идеален для маркетологов и ...

meta-ads-mcp

npm version License: MIT

MCP server for the Meta Marketing API v25.0 — 135 tools for managing Facebook & Instagram ad campaigns, audiences, creatives, insights, catalogs, and more.

When to Use

Use this MCP when you need to:

  • "Create a new Facebook ad campaign" — use create_campaign, create_adset, create_ad, and create_creative to build a full funnel
  • "Check how my ads are performing today" — use get_account_insights or get_campaign_insights with today's date range
  • "Pause all campaigns with ROAS below 2" — use list_campaigns + get_campaign_insights to find underperformers, then update_campaign to pause
  • "Set up A/B test between two ad creatives" — use create_experiment to run a controlled test between ad sets
  • "Create a lookalike audience from my customers" — use create_custom_audience, add_users_to_audience, then create_lookalike_audience
  • "Upload ad images and create a carousel ad" — use upload_image for each image, then create_creative with carousel format
  • "Get a detailed performance report for last 30 days" — use create_async_report for large date ranges, then get_async_report to retrieve
  • "Search the Facebook Ad Library for competitor ads" — use search_ad_library to find public ad data
  • "Set up automated rules to pause underperforming ads" — use create_rule with conditions like CPA > threshold
  • "Manage my product catalog for dynamic ads" — use create_catalog, create_feed, and upload_feed to set up dynamic product ads
Инструменты были проиндексированы:
add_business_user

Добавляет пользователя в настроенную организацию по email. Требует переменную окружения META_BUSINESS_ID.

Параметры
  • emailstringобязательный

    Email address of the user to add

  • roleenumобязательный

    Role for the new user

add_to_block_list

Добавляет URL-адреса издателей в существующий список блокировки.

Параметры
  • list_idstringобязательный

    Block list ID

  • urlsstringобязательный

    JSON array of URLs to block (e.g. '["example.com","bad-site.com"]')

add_users_to_audience

Добавляет пользователей в пользовательскую аудиторию. Payload должен быть JSON-строкой, содержащей хешированные данные пользователей, с массивом schema, определяющим типы данных (например, EMAIL, PHONE, FN, LN).

Параметры
  • audience_idstringобязательный

    Audience ID

  • payloadstringобязательный

    JSON string: {schema: ['EMAIL','PHONE',...], data: [['hash1','hash2',...], ...]}. All PII must be SHA-256 hashed.

batch_products

Массово создаёт, обновляет или удаляет товары в каталоге. Поддерживает до 5000 позиций за запрос. Операции обновления поддерживают upsert.

Параметры
  • allow_upsertboolean

    Allow UPDATE to create items if they don't exist (default false)

  • catalog_idstringобязательный

    Product catalog ID

  • requestsstringобязательный

    JSON array of batch requests. Each: {method: 'CREATE'|'UPDATE'|'DELETE', retailer_id: string, data?: {name, description, price, url, image_url, availability, ...}}

copy_ad

Копирует существующее объявление. Создаёт дубликат в том же или другом наборе объявлений.

Параметры
  • ad_idstringобязательный

    Source ad ID to copy

  • adset_idstring

    Target ad set ID. If omitted, copies to same ad set

  • namestring

    Name for the copied ad

  • statusstring

    Status for copied ad (default PAUSED)

copy_adset

Скопировать существующую группу объявлений. Создаёт дубликат в той же или другой кампании.

Параметры
  • adset_idstringобязательный

    Source ad set ID to copy

  • campaign_idstring

    Target campaign ID. If omitted, copies to same campaign

  • deep_copyboolean

    Copy ads within the ad set (default true)

  • namestring

    Name for the copied ad set

  • statusstring

    Status for copied ad set (default PAUSED)

copy_campaign

Скопировать существующую кампанию. Создает дубликат с возможностью переопределения имени. Копирует структуру, включая группы объявлений и объявления.

Параметры
  • campaign_idstringобязательный

    Source campaign ID to copy

  • deep_copyboolean

    Copy ad sets and ads within the campaign (default true)

  • namestring

    Name for the copied campaign. Defaults to 'Copy of <original>'

  • statusstring

    Status for copied campaign (default PAUSED)

create_ad

Создаёт новое объявление. Требует name, adset_id и creative (JSON object_story_spec). По умолчанию имеет статус PAUSED.

Параметры
  • account_idstring

    Ad account ID to create the ad in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • adset_idstringобязательный

    Parent ad set ID

  • creativestringобязательный

    JSON string of creative spec (object_story_spec with page_id, link_data/photo_data/video_data). Note: as of v26.0, a creative with applink_treatment=web_only can no longer be attached to an ad in a campaign using Website and App conversion locations — use automatic destination selection or a compatible manual destination instead.

  • namestringобязательный

    Ad name

  • statusstring

    Ad status (default PAUSED)

  • tracking_specsstring

    JSON string of tracking specs array

create_adset

Создаёт новый набор объявлений. Требуются: name, campaign_id, budget, optimization_goal, billing_event и targeting. По умолчанию — статус PAUSED.

Параметры
  • account_idstring

    Ad account ID to create the ad set in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • bid_strategystring

    Bid strategy: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS

  • billing_eventstringобязательный

    Billing event: APP_INSTALLS, CLICKS, IMPRESSIONS, LINK_CLICKS, NONE, OFFER_CLAIMS, PAGE_LIKES, POST_ENGAGEMENT, THRUPLAY, PURCHASE, LISTING_INTERACTION

  • campaign_idstringобязательный

    Parent campaign ID

  • daily_budgetstring

    Daily budget in currency cents (e.g. '5000' = $50.00)

  • end_timestring

    End time (ISO 8601)

  • lifetime_budgetstring

    Lifetime budget in currency cents

  • namestringобязательный

    Ad set name

  • optimization_goalstringобязательный

    Optimization goal: NONE, APP_INSTALLS, AD_RECALL_LIFT, ENGAGED_USERS, EVENT_RESPONSES, IMPRESSIONS, LEAD_GENERATION, QUALITY_LEAD, LINK_CLICKS, OFFSITE_CONVERSIONS, PAGE_LIKES, POST_ENGAGEMENT, QUALITY_CALL, REACH, LANDING_PAGE_VIEWS, VISIT_INSTAGRAM_PROFILE, ENGAGED_PAGE_VIEWS, VALUE, THRUPLAY, DERIVED_EVENTS, APP_INSTALLS_AND_OFFSITE_CONVERSIONS, CONVERSATIONS, IN_APP_VALUE, MESSAGING_PURCHASE_CONVERSION, MESSAGING_DEEP_CONVERSATION_AND_FOLLOW, SUBSCRIBERS, REMINDERS_SET, MEANINGFUL_CALL_ATTEMPT, PROFILE_VISIT, PROFILE_AND_PAGE_ENGAGEMENT, ADVERTISER_SILOED_VALUE, AUTOMATIC_OBJECTIVE, MESSAGING_APPOINTMENT_CONVERSION

  • promoted_objectstring

    JSON string of the promoted_object spec. Required for many objectives, e.g. OUTCOME_SALES needs {"pixel_id":"...","custom_event_type":"PURCHASE"}, OUTCOME_APP_PROMOTION needs {"application_id":"...","object_store_url":"..."}, OUTCOME_ENGAGEMENT page-like ads need {"page_id":"..."}. Omitting it when the objective requires one causes ad set creation to fail.

  • start_timestring

    Start time (ISO 8601)

  • statusstring

    Ad set status (default PAUSED)

  • targetingstringобязательный

    JSON string of targeting spec (age_min, age_max, genders, geo_locations, interests, etc.). Advantage+ Audience automation and other flags go inside this object too, e.g. targeting_automation: {"advantage_audience":1}. As of v26.0, ad sets in the Housing, Employment, or Financial Products and Services (HEC-F) special ad categories with relaxable (non-broad) targeting must explicitly set targeting.targeting_automation.advantage_audience to 1 or 0 — omitting it now returns ADS_TARGETING__REQUIRE_EXPLICIT_ADVANTAGE_AUDIENCE_FLAG. Not required for broad/default audience setups. Also note: as of Marketing API v26.0, the Instagram Explore Feed placement was removed (explicitly specifying it in publisher_platforms/instagram_positions now returns an error) and the 'story' value in messenger_positions is silently dropped.

create_async_report

Создает асинхронный аналитический отчёт для больших запросов данных. Возвращает report_run_id для опроса с помощью get_async_report.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • breakdownsstring

    Breakdown dimensions: age,gender,country,region,placement,device_platform

  • date_presetstring

    Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR

  • fieldsstring

    Comma-separated insight fields

  • filteringstring

    JSON string for filtering

  • levelstring

    Aggregation level: campaign, adset, ad

  • time_incrementstring

    Time granularity: all_days, 1, 7, monthly

  • time_rangestring

    JSON string {since,until} in YYYY-MM-DD format

create_block_list

Создаёт новый список заблокированных издателей для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to create the block list in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • namestringобязательный

    Name for the block list

create_budget_schedule

Создаёт новый график рекламного бюджета для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to create the schedule in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • budget_valuestringобязательный

    Budget amount in account currency cents

  • budget_value_typestringобязательный

    Budget value type (e.g. ABSOLUTE, MULTIPLIER)

  • time_endstringобязательный

    Schedule end time (ISO 8601 or Unix timestamp)

  • time_startstringобязательный

    Schedule start time (ISO 8601 or Unix timestamp)

create_campaign

Создать новую рекламную кампанию. По умолчанию имеет статус ПРИОСТАНОВЛЕНО. Требуется название и цель. Бюджет можно задать на уровне кампании или набора объявлений.

Параметры
  • account_idstring

    Ad account ID to create the campaign in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • bid_strategystring

    Bid strategy: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS. Meta defaults new campaigns to LOWEST_COST_WITH_BID_CAP, which requires a bid_amount on every ad set — pass LOWEST_COST_WITHOUT_CAP to avoid that.

  • daily_budgetstring

    Daily budget in account currency cents (e.g. '5000' = $50.00)

  • is_adset_budget_sharing_enabledboolean

    Whether ad sets under this campaign can share budget with each other. Required on some newer ad accounts — omitting it can cause campaign creation to fail with 'Must specify True or False in is_adset_budget_sharing_enabled'.

  • lifetime_budgetstring

    Lifetime budget in account currency cents

  • namestringобязательный

    Campaign name

  • objectiveenumобязательный

    Campaign objective

  • special_ad_categoriesstring

    JSON array of special ad categories: HOUSING, EMPLOYMENT, FINANCIAL_PRODUCTS_SERVICES, ISSUES_ELECTIONS_POLITICS, NONE. This field is required by Meta on every campaign — pass '[]' or '["NONE"]' if none apply. CREDIT was renamed to FINANCIAL_PRODUCTS_SERVICES; the old name is no longer accepted.

  • special_ad_category_countrystring

    JSON array of ISO 3166-1 alpha-2 country codes, e.g. '["US"]'. Required for ISSUES_ELECTIONS_POLITICS (which also requires authorization to run ads in those countries). For HOUSING, EMPLOYMENT, and FINANCIAL_PRODUCTS_SERVICES it is optional and defaults to the ad account's listed tax country if omitted.

  • spend_capstring

    Lifetime spend cap for the campaign, in account currency cents. Once set it cannot be removed, only raised or reset — pass '0' to reset/clear it.

  • start_timestring

    Campaign start time (ISO 8601 format)

  • statusstring

    Campaign status (default PAUSED)

  • stop_timestring

    Campaign stop time (ISO 8601 format)

create_canvas

Создаёт новый Instant Experience (Canvas) на странице Facebook. Требует page_id и JSON-массив body_elements, определяющий макет Canvas.

Параметры
  • body_elementsstringобязательный

    JSON array of canvas body elements (buttons, carousels, photos, videos, text, etc.)

  • namestring

    Canvas name

  • page_idstringобязательный

    Facebook Page ID to create the canvas on

create_catalog

Создайте новый каталог товаров для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to create the catalog in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • namestringобязательный

    Catalog name

  • verticalstring

    Catalog vertical: commerce, hotels, flights, destinations, home_listings, vehicles

create_creative

Создаёт новый рекламный креатив с object_story_spec. Спецификация определяет содержимое рекламы (ссылку, фото или видео) и связанную страницу Facebook. Примечания для v26.0: poll_spec и тип poll в interactive_components_spec больше не поддерживаются и будут отклоняться. Если у рекламодателя есть магазин, подходящие креативы теперь по умолчанию имеют destination_spec.destination_type=WEBSITE_AND_SHOP. Установите значение WEBSITE_AND_SHOP_OPT_OUT, чтобы отказаться.

Параметры
  • account_idstring

    Ad account ID to create the creative in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • asset_feed_specstring

    JSON string of asset_feed_spec for dynamic creative

  • namestringобязательный

    Creative name

  • object_story_specstringобязательный

    JSON string of object_story_spec (page_id, link_data/photo_data/video_data). As of v26.0, it can also include wamo_whatsapp_identity_spec to deliver ads in WhatsApp Status (Offsite-conversion optimization is supported for Sales, Leads, Engagement, and Landing Page Views).

  • url_tagsstring

    URL tags to append to all links

create_custom_audience

Создать новую пользовательскую аудиторию. Подтип определяет источник аудитории (CUSTOM, WEBSITE, APP, OFFLINE_CONVERSION, LOOKALIKE, ENGAGEMENT и т.д.).

Параметры
  • account_idstring

    Ad account ID to create the audience in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • customer_file_sourcestring

    Source of customer file: USER_PROVIDED_ONLY, PARTNER_PROVIDED_ONLY, BOTH_USER_AND_PARTNER_PROVIDED

  • descriptionstring

    Audience description

  • namestringобязательный

    Audience name

  • subtypeenumобязательный

    Audience subtype

create_dynamic_creative

Создаёт динамическое объявление с помощью asset_feed_spec. Meta автоматически комбинирует различные изображения, видео, заголовки, тексты и CTA, чтобы найти наиболее эффективные комбинации.

Параметры
  • account_idstring

    Ad account ID to create the creative in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • asset_feed_specstringобязательный

    JSON string of asset_feed_spec with arrays: images (hash), videos (video_id), bodies (text), titles (text), descriptions (text), call_to_action_types

  • namestringобязательный

    Creative name

create_experiment

Создать новый A/B-эксперимент (рекламное исследование)

Параметры
  • account_idstring

    Ad account ID to create the experiment in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • cellsstringобязательный

    JSON array of test cells: [{name, campaign_id}]

  • descriptionstring

    Experiment description

  • end_timestringобязательный

    End time in ISO 8601 or Unix timestamp

  • namestringобязательный

    Experiment name

  • start_timestringобязательный

    Start time in ISO 8601 or Unix timestamp

  • typestring

    Study type

create_feed

Создаёт новый фид товаров для каталога.

Параметры
  • catalog_idstringобязательный

    Product catalog ID

  • file_urlstring

    URL of the feed file

  • namestringобязательный

    Feed name

  • schedulestring

    JSON string for feed schedule configuration

create_lead_form

Создаёт новую форму для генерации лидов на странице Facebook. Требует разрешения pages_manage_ads.

Параметры
  • follow_up_action_urlstring

    URL to redirect after submission

  • namestringобязательный

    Lead form name

  • page_idstringобязательный

    Facebook Page ID

  • privacy_policy_urlstringобязательный

    URL to privacy policy

  • questionsstringобязательный

    JSON array of questions. Each: {key: string, type: 'CUSTOM'|'EMAIL'|'PHONE'|'FULL_NAME'|'CITY'|'STATE'|'COUNTRY'|'ZIP'|'JOB_TITLE'|'COMPANY_NAME', label?: string}

  • thank_you_pagestring

    JSON object: {title: string, body: string, button_text?: string, button_type?: 'VIEW_WEBSITE'|'DOWNLOAD'}

create_lookalike_audience

Создаёт похожую аудиторию на основе существующей пользовательской аудитории. Параметр Ratio (1-10) определяет, насколько новая аудитория похожа на исходную.

Параметры
  • account_idstring

    Ad account ID to create the audience in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • lookalike_specstringобязательный

    JSON string: {country: 'US', ratio: 0.01-0.10} where ratio is the lookalike percentage (1%-10%)

  • namestringобязательный

    Lookalike audience name

  • origin_audience_idstringобязательный

    Source custom audience ID

create_offline_event_set

Создаёт новый набор данных офлайн-конверсии.

Параметры
  • account_idstring

    Ad account ID to create the event set in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • descriptionstring

    Event set description

  • namestringобязательный

    Event set name

create_product_set

Создаёт новый набор товаров в каталоге.

Параметры
  • catalog_idstringобязательный

    Product catalog ID

  • filterstring

    JSON string of filter rules for the product set

  • namestringобязательный

    Product set name

create_rf_prediction

Создаёт новый прогноз охвата и частоты. Принимает спецификацию таргетинга в виде JSON-строки, бюджет в центах и информацию о расписании.

Параметры
  • account_idstring

    Ad account ID to create the prediction in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • budgetnumberобязательный

    Budget in account currency cents

  • destination_idstringобязательный

    Destination ID (e.g. Facebook Page ID)

  • frequency_capnumberобязательный

    Maximum frequency cap per user

  • start_timestringобязательный

    Prediction start time (ISO 8601 or Unix timestamp)

  • stop_timestringобязательный

    Prediction stop time (ISO 8601 or Unix timestamp)

  • target_specstringобязательный

    JSON string of targeting specification

create_rule

Создаёт новое автоматическое правило для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to create the rule in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • evaluation_specstringобязательный

    JSON string defining rule conditions

  • execution_specstringобязательный

    JSON string defining rule actions

  • namestringобязательный

    Rule name

  • schedule_specstring

    JSON string defining rule schedule

create_system_user

Создает нового системного пользователя в настроенном бизнесе. Требует переменную окружения META_BUSINESS_ID.

Параметры
  • namestringобязательный

    Name for the system user

  • roleenumобязательный

    Role for the system user

debug_token

Отлаживает токен доступа для проверки его свойств, разрешений, срока действия и валидности. Требует META_APP_ID и META_APP_SECRET.

Параметры
  • input_tokenstringобязательный

    Access token to debug/inspect

delete_ad

Удалить объявление. Это действие необратимо.

Параметры
  • ad_idstringобязательный

    Ad ID to delete

delete_adset

Удалить набор объявлений. Это действие необратимо.

Параметры
  • adset_idstringобязательный

    Ad set ID to delete

delete_audience

Удалить пользовательскую аудиторию. Это действие необратимо.

Параметры
  • audience_idstringобязательный

    Audience ID to delete

delete_block_list

Удалить список блокировки издателя. Это действие необратимо.

Параметры
  • list_idstringобязательный

    Block list ID to delete

delete_budget_schedule

Удалить бюджетный график. Это действие необратимо.

Параметры
  • schedule_idstringобязательный

    Budget schedule ID to delete

delete_campaign

Удалить кампанию. Это действие необратимо.

Параметры
  • campaign_idstringобязательный

    Campaign ID to delete

delete_canvas

Удалить Instant Experience (Canvas). Это действие необратимо.

Параметры
  • canvas_idstringобязательный

    Canvas ID to delete

delete_image

Удалить изображение рекламы по хешу. Это действие необратимо.

Параметры
  • account_idstring

    Ad account ID the image belongs to (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • hashstringобязательный

    Image hash to delete

delete_rf_prediction

Удалить прогноз охвата и частоты. Это действие необратимо.

Параметры
  • prediction_idstringобязательный

    Prediction ID to delete

delete_rule

Удалить автоматическое правило.

Параметры
  • rule_idstringобязательный

    Rule ID

delete_video

Удалить рекламное видео. Это действие необратимо.

Параметры
  • video_idstringобязательный

    Video ID to delete

exchange_token

Обменивает кратковременный токен доступа на долгоживущий токен. Требует настройки META_APP_ID и META_APP_SECRET.

Параметры
  • short_lived_tokenstringобязательный

    Short-lived access token to exchange

generate_preview

Генерирует предпросмотр рекламы без необходимости в существующем объявлении. Предоставьте спецификацию креатива напрямую, чтобы увидеть, как это будет выглядеть.

Параметры
  • account_idstring

    Ad account ID to generate the preview in (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • ad_formatstringобязательный

    Ad format: DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, INSTAGRAM_STORY, RIGHT_COLUMN_STANDARD, etc.

  • creativestringобязательный

    JSON string of creative spec: {object_story_spec: {...}} or {object_story_id: '...'}

get_account_activities

Получить журнал активности для рекламного аккаунта. Показывает изменения, внесенные в кампании, группы объявлений, объявления и т.д.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

get_account_insights

Получает аналитику эффективности для рекламного аккаунта. Возвращает метрики, такие как показы, клики, расходы, охват и т.д.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • breakdownsstring

    Breakdown dimensions: age,gender,country,region,placement,device_platform

  • date_presetstring

    Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR

  • fieldsstring

    Comma-separated insight fields

  • filteringstring

    JSON string for filtering

  • levelstring

    Aggregation level: campaign, adset, ad

  • time_incrementstring

    Time granularity: all_days, 1, 7, monthly

  • time_rangestring

    JSON string {since,until} in YYYY-MM-DD format

get_ad

Получить детали конкретного объявления по ID.

Параметры
  • ad_idstringобязательный

    Ad ID

  • fieldsstring

    Comma-separated fields to return

get_ad_account

Получить сведения о настроенном рекламном аккаунте: статус, баланс, валюта, часовой пояс и информация о расходах.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • fieldsstring

    Comma-separated fields to return

get_ad_insights

Получает показатели эффективности для конкретного объявления.

Параметры
  • ad_idstringобязательный

    Ad ID

  • breakdownsstring

    Breakdown dimensions: age,gender,country,region,placement,device_platform

  • date_presetstring

    Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR

  • fieldsstring

    Comma-separated insight fields

  • filteringstring

    JSON string for filtering

  • levelstring

    Aggregation level: campaign, adset, ad

  • time_incrementstring

    Time granularity: all_days, 1, 7, monthly

  • time_rangestring

    JSON string {since,until} in YYYY-MM-DD format

get_ad_preview

Получить предварительный просмотр объявления в определённом формате. Возвращает HTML iframe для рендеринга.

Параметры
  • ad_formatstringобязательный

    Ad format: DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, INSTAGRAM_STORY, RIGHT_COLUMN_STANDARD, etc.

  • ad_idstringобязательный

    Ad ID

get_adset

Получает подробную информацию о конкретном наборе объявлений по ID.

Параметры
  • adset_idstringобязательный

    Ad set ID

  • fieldsstring

    Comma-separated fields to return

get_adset_ads

Получить все объявления, принадлежащие конкретному набору объявлений.

Параметры
  • adset_idstringобязательный

    Ad set ID

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

get_adset_insights

Получает аналитику производительности для конкретного рекламного набора.

Параметры
  • adset_idstringобязательный

    Ad Set ID

  • breakdownsstring

    Breakdown dimensions: age,gender,country,region,placement,device_platform

  • date_presetstring

    Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR

  • fieldsstring

    Comma-separated insight fields

  • filteringstring

    JSON string for filtering

  • levelstring

    Aggregation level: campaign, adset, ad

  • time_incrementstring

    Time granularity: all_days, 1, 7, monthly

  • time_rangestring

    JSON string {since,until} in YYYY-MM-DD format

get_adset_leads

Получить лиды, сгенерированные конкретным набором объявлений. Требуется разрешение leads_retrieval.

Параметры
  • adset_idstringобязательный

    Ad set ID

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

get_adset_targeting_sentence

Получить читаемое описание таргетинга для набора объявлений. Преобразует спецификацию таргетинга в читаемые предложения.

Параметры
  • adset_idstringобязательный

    Ad set ID

get_async_report

Проверить статус и получить результаты асинхронного отчёта об инсайтах.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • report_run_idstringобязательный

    Report run ID from create_async_report

get_audience

Получить сведения о конкретной пользовательской аудитории по ID.

Параметры
  • audience_idstringобязательный

    Audience ID

  • fieldsstring

    Comma-separated fields to return

get_audience_health

Получает состояние здоровья и готовность к доставке пользовательской аудитории. Показывает коэффициент совпадения, размер и статус операции.

Параметры
  • audience_idstringобязательный

    Custom audience ID

get_batch_status

Проверяет статус пакетной операции каталога.

Параметры
  • catalog_idstringобязательный

    Product catalog ID

  • handlestringобязательный

    Batch handle returned from batch_products

get_business

Получить сведения о конкретном бизнесе по ID.

Параметры
  • business_idstringобязательный

    Business ID

  • fieldsstring

    Comma-separated fields to return

get_campaign

Получить детали конкретной кампании по ID.

Параметры
  • campaign_idstringобязательный

    Campaign ID

  • fieldsstring

    Comma-separated fields to return

get_campaign_ads

Получить все объявления, принадлежащие конкретной кампании.

Параметры
  • afterstring

    Pagination cursor for next page

  • campaign_idstringобязательный

    Campaign ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

get_campaign_adsets

Получает все рекламные наборы, принадлежащие конкретной кампании.

Параметры
  • afterstring

    Pagination cursor for next page

  • campaign_idstringобязательный

    Campaign ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

get_campaign_insights

Получает аналитические данные об эффективности для конкретной кампании.

Параметры
  • breakdownsstring

    Breakdown dimensions: age,gender,country,region,placement,device_platform

  • campaign_idstringобязательный

    Campaign ID

  • date_presetstring

    Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR

  • fieldsstring

    Comma-separated insight fields

  • filteringstring

    JSON string for filtering

  • levelstring

    Aggregation level: campaign, adset, ad

  • time_incrementstring

    Time granularity: all_days, 1, 7, monthly

  • time_rangestring

    JSON string {since,until} in YYYY-MM-DD format

get_campaign_leads

Получает лиды, сгенерированные конкретной кампанией. Требуется разрешение leads_retrieval.

Параметры
  • afterstring

    Pagination cursor for next page

  • campaign_idstringобязательный

    Campaign ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

get_canvas

Получить детали конкретного Instant Experience (Canvas) по ID.

Параметры
  • canvas_idstringобязательный

    Canvas ID

  • fieldsstring

    Comma-separated fields to return

get_catalog

Получить подробную информацию о конкретном каталоге товаров.

Параметры
  • catalog_idstringобязательный

    Product catalog ID

  • fieldsstring

    Comma-separated fields to return

get_creative

Получить детали конкретного креатива объявления по ID.

Параметры
  • creative_idstringобязательный

    Creative ID

  • fieldsstring

    Comma-separated fields to return

get_delivery_estimate

Получить оценку доставки для рекламы, включая предполагаемый ежедневный охват и стоимость.

Параметры
  • adset_idstringобязательный

    Ad Set ID

  • optimization_goalstring

    Optimization goal to estimate for

get_experiment

Получить подробности конкретного эксперимента (ad study).

Параметры
  • experiment_idstringобязательный

    Experiment (ad study) ID

  • fieldsstring

    Comma-separated fields to return

get_experiment_results

Получить результаты/ячейки эксперимента (рекламное исследование)

Параметры
  • experiment_idstringобязательный

    Experiment (ad study) ID

  • fieldsstring

    Comma-separated fields to return

get_feed_uploads

Получить историю загрузок для товарного фида.

Параметры
  • afterstring

    Pagination cursor for next page

  • feed_idstringобязательный

    Product feed ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

get_form_leads

Получает лиды, отправленные через форму генерации лидов.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • form_idstringобязательный

    Lead form ID

  • limitnumber

    Number of results to return

get_image

Получить детали конкретного рекламного изображения по ID.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • image_idstringобязательный

    Image ID

get_lead

Получить данные конкретного лида по ID.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • lead_idstringобязательный

    Lead ID

get_lead_form

Получить сведения о конкретной форме генерации лидов.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • form_idstringобязательный

    Lead form ID

get_product

Получить сведения о конкретном продукте.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • product_idstringобязательный

    Product ID

get_product_set

Получить подробности конкретного набора продуктов.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • set_idstringобязательный

    Product set ID

get_reach_estimate

Получает оценку охвата аудитории для заданной спецификации таргетинга. Полезно для планирования кампаний до их создания.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • targeting_specstringобязательный

    JSON string of targeting spec (same format as ad set targeting)

get_rf_prediction

Получить подробную информацию о конкретном прогнозе охвата и частоты по ID.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • prediction_idstringобязательный

    Prediction ID

get_rule

Получить детали конкретного автоматического правила.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • rule_idstringобязательный

    Rule ID

get_saved_audience

Получить сведения о конкретной сохранённой аудитории по ID.

Параметры
  • audience_idstringобязательный

    Saved audience ID

  • fieldsstring

    Comma-separated fields to return

get_targeting_suggestions

Получить предложения по таргетингу на основе существующих критериев таргетинга. Meta предлагает связанные интересы, поведение и демографические данные.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • targeting_liststringобязательный

    JSON string of current targeting criteria to get suggestions for

get_video

Получает детали конкретного рекламного видео по ID.

Параметры
  • fieldsstring

    Comma-separated fields to return

  • video_idstringобязательный

    Video ID

list_account_users

Выводит список пользователей, имеющих доступ к рекламному аккаунту, с их ролями и разрешениями.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_ad_accounts

Выводит список всех рекламных кабинетов, доступных текущему пользователю. Возвращает результаты с постраничной разбивкой.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_ads

Вывести список объявлений в рекламном аккаунте. Опционально можно отфильтровать по кампании, группе объявлений или статусу.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • adset_idstring

    Filter by ad set ID

  • afterstring

    Pagination cursor for next page

  • campaign_idstring

    Filter by campaign ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

  • statusstring

    Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

list_adsets

Перечисляет группы объявлений в рекламном аккаунте. Опционально фильтрует по кампании или статусу.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • campaign_idstring

    Filter by campaign ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

  • statusstring

    Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

list_block_lists

Выводит списки блокировки издателей для рекламного аккаунта. Возвращает постраничные результаты.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_budget_schedules

Вывести список расписаний рекламного бюджета для рекламного аккаунта. Возвращает результаты с постраничной разбивкой.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_business_ad_accounts

Выводит список рекламных аккаунтов, принадлежащих настроенному бизнесу. Требуется переменная окружения META_BUSINESS_ID.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_businesses

Выводит список всех организаций, доступных текущему пользователю. Возвращает постраничные результаты.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_business_instagram_accounts

Перечисляет аккаунты Instagram, принадлежащие настроенному бизнесу. Требует переменную окружения META_BUSINESS_ID.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_business_pages

Перечисляет Facebook Pages, принадлежащие настроенному бизнесу. Требуется переменная окружения META_BUSINESS_ID.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_business_users

Список пользователей настроенного аккаунта. Требует переменную окружения META_BUSINESS_ID.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_campaigns

Выводит список кампаний в рекламном аккаунте. Поддерживает фильтрацию по статусу и цели. Возвращает результаты с постраничной разбивкой.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • beforestring

    Pagination cursor for previous page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

  • objectivestring

    Filter by objective: OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, OUTCOME_APP_PROMOTION

  • statusstring

    Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

list_canvases

Вывести список креативов Instant Experience (Canvas) в рекламном аккаунте.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_catalogs

Выведи список каталогов товаров для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

list_creatives

Вывести список рекламных креативов в рекламном аккаунте.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_custom_audiences

Вывести список пользовательских аудиторий в рекламном аккаунте.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_experiments

Выведи список A/B тестов (рекламных экспериментов) для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

list_feeds

Вывести список фидов товаров для каталога.

Параметры
  • afterstring

    Pagination cursor for next page

  • catalog_idstringобязательный

    Product catalog ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

list_images

Вывести список рекламных изображений, загруженных в рекламный аккаунт.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_lead_forms

Список лид-форм для страницы Facebook.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

  • page_idstringобязательный

    Facebook Page ID

list_offline_event_sets

Выводит список наборов данных офлайн-конверсий для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

list_products

Вывести список товаров в каталоге.

Параметры
  • afterstring

    Pagination cursor for next page

  • catalog_idstringобязательный

    Product catalog ID

  • fieldsstring

    Comma-separated fields to return

  • filterstring

    JSON string of filter rules

  • limitnumber

    Number of results to return

list_product_sets

Вывести список наборов товаров в каталоге.

Параметры
  • afterstring

    Pagination cursor for next page

  • catalog_idstringобязательный

    Product catalog ID

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

list_rf_predictions

Выводит прогнозы охвата и частоты для рекламного аккаунта. Возвращает результаты с разбивкой на страницы.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_rules

Выведи список автоматических правил для рекламного аккаунта.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results to return

list_saved_audiences

Список сохраненных аудиторий в рекламном аккаунте. Сохраненные аудитории - это повторно используемые шаблоны таргетинга.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_system_users

Вывести системных пользователей настроенного бизнеса. Требует переменной окружения META_BUSINESS_ID.

Параметры
  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

list_videos

Вывести список рекламных видео, загруженных в рекламный аккаунт.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

refresh_token

Обновляет долгоживущий токен доступа для продления срока его действия. Возвращает новый долгоживущий токен.

Параметры
  • long_lived_tokenstringобязательный

    Long-lived access token to refresh

remove_business_user

Удаляет пользователя из настроенного бизнеса. Требует переменную окружения META_BUSINESS_ID.

Параметры
  • user_idstringобязательный

    User ID to remove from the business

remove_from_block_list

Удаляет URL издателей из существующего списка блокировки.

Параметры
  • list_idstringобязательный

    Block list ID

  • urlsstringобязательный

    JSON array of URLs to remove (e.g. '["example.com"]')

remove_users_from_audience

Удаляет пользователей из пользовательской аудитории. Формат полезной нагрузки такой же, как у add_users_to_audience.

Параметры
  • audience_idstringобязательный

    Audience ID

  • payloadstringобязательный

    JSON string: {schema: ['EMAIL','PHONE',...], data: [['hash1','hash2',...], ...]}. All PII must be SHA-256 hashed.

search_ad_library

Ищет объявления в Meta Ad Library. Поддерживает поиск по ключевым словам, странам и типу объявлений. Полезен для конкурентного анализа и прозрачности.

Параметры
  • ad_reached_countriesstringобязательный

    Comma-separated country codes where ads were shown (e.g. 'US,GB,KR')

  • ad_typestring

    Ad type filter: ALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, etc.

  • afterstring

    Pagination cursor for next page

  • fieldsstring

    Comma-separated fields to return

  • limitnumber

    Number of results (default 25)

  • order_bystring

    Sort order for results

  • search_termsstringобязательный

    Keywords to search for in ads

search_locations

Ищет географические местоположения (страны, регионы, города, почтовые индексы) для таргетинга рекламы.

Параметры
  • limitnumber

    Number of results (default 25)

  • location_typesstring

    Comma-separated location types: country, region, city, zip, geo_market, electoral_district

  • qstringобязательный

    Search query (e.g. 'New York', 'California', 'United States')

search_targeting

Ищет параметры таргетинга (интересы, поведение, демография и т.д.) по ключевому слову. Используйте это, чтобы найти валидные идентификаторы таргетинга для спецификаций таргетинга группы объявлений.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • limitnumber

    Number of results (default 25)

  • qstringобязательный

    Search query (e.g. 'fitness', 'technology', 'cooking')

  • typestring

    Targeting type filter: adinterest, adgeolocation, adeducationschool, adeducationmajor, adworkemployer, adworkposition, adlocale, etc.

search_targeting_map

Сопоставляет идентификаторы нацеливания с их полными данными (имена, типы, пути). Полезно для разрешения ID, полученных из других конечных точек.

Параметры
  • account_idstring

    Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • targeting_liststringобязательный

    JSON array of targeting IDs to look up

send_conversion_event

Отправляет серверное событие конверсии через Conversions API (pixel).

Параметры
  • eventsstringобязательный

    JSON array of events: [{event_name, event_time, user_data, custom_data, action_source}]

send_offline_event

Отправляет событие офлайн-конверсии в набор офлайн-событий.

Параметры
  • eventsstringобязательный

    JSON array of offline events

  • event_set_idstringобязательный

    Offline event set ID

update_ad

Обновить существующее объявление. Будут изменены только указанные поля.

Параметры
  • ad_idstringобязательный

    Ad ID to update

  • creativestring

    New creative spec as JSON string

  • namestring

    New ad name

  • statusstring

    New status: ACTIVE, PAUSED, DELETED, ARCHIVED

  • tracking_specsstring

    New tracking specs as JSON string

update_ad_account

Обновляет сконфигурированные настройки рекламного аккаунта. Будут изменены только указанные поля.

Параметры
  • account_idstring

    Ad account ID to update (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • namestring

    New account name

  • spend_capstring

    Account spend cap in currency cents (e.g. '100000' = $1000.00)

  • timezone_namestring

    New timezone (e.g. 'America/New_York')

update_adset

Обновить существующий ad set. Будут изменены только указанные поля.

Параметры
  • adset_idstringобязательный

    Ad set ID to update

  • bid_amountstring

    New bid amount in currency cents

  • daily_budgetstring

    New daily budget in currency cents

  • end_timestring

    New end time (ISO 8601)

  • lifetime_budgetstring

    New lifetime budget in currency cents

  • namestring

    New ad set name

  • start_timestring

    New start time (ISO 8601)

  • statusstring

    New status: ACTIVE, PAUSED, DELETED, ARCHIVED

  • targetingstring

    New targeting spec as JSON string. Advantage+ Audience automation flags go inside this object, e.g. targeting_automation: {"advantage_audience":1} — required for HEC-F (Housing/Employment/Financial Products and Services) ad sets with relaxable, non-broad targeting as of v26.0. Note: the Instagram Explore Feed placement was removed in Marketing API v26.0 — requests that explicitly include it now return an error.

update_audience

Обновляет существующую кастомную аудиторию. Будут изменены только указанные поля.

Параметры
  • audience_idstringобязательный

    Audience ID to update

  • descriptionstring

    New audience description

  • namestring

    New audience name

update_budget_schedule

Обновить существующий бюджетный график. Будут изменены только переданные поля.

Параметры
  • budget_valuestring

    New budget amount in account currency cents

  • schedule_idstringобязательный

    Budget schedule ID to update

  • time_endstring

    New schedule end time

  • time_startstring

    New schedule start time

update_campaign

Обновить существующую кампанию. Будут изменены только переданные поля.

Параметры
  • bid_strategystring

    New bid strategy: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS

  • campaign_idstringобязательный

    Campaign ID to update

  • daily_budgetstring

    New daily budget in currency cents

  • lifetime_budgetstring

    New lifetime budget in currency cents

  • namestring

    New campaign name

  • spend_capstring

    Lifetime spend cap for the campaign, in account currency cents. Once set it cannot be removed, only raised or reset — pass '0' to reset/clear it.

  • start_timestring

    New start time (ISO 8601)

  • statusstring

    New status: ACTIVE, PAUSED, DELETED, ARCHIVED

  • stop_timestring

    New stop time (ISO 8601)

update_catalog

Обновляет существующий каталог продуктов.

Параметры
  • catalog_idstringобязательный

    Product catalog ID

  • namestring

    New catalog name

update_creative

Обновить существующий рекламный креатив. После создания можно изменить только name и url_tags.

Параметры
  • creative_idstringобязательный

    Creative ID to update

  • namestring

    New creative name

  • url_tagsstring

    New URL tags

update_experiment

Обновить существующий эксперимент (изучение рекламы).

Параметры
  • descriptionstring

    New experiment description

  • experiment_idstringобязательный

    Experiment (ad study) ID

  • namestring

    New experiment name

update_product

Обновить существующий товар в каталоге.

Параметры
  • availabilitystring

    Product availability: in stock, out of stock, etc.

  • descriptionstring

    Product description

  • image_urlstring

    Product image URL

  • namestring

    Product name

  • pricestring

    Product price (e.g. '9.99 USD')

  • product_idstringобязательный

    Product ID

  • urlstring

    Product URL

update_product_set

Обновить существующий набор продуктов.

Параметры
  • filterstring

    JSON string of updated filter rules

  • namestring

    New product set name

  • set_idstringобязательный

    Product set ID

update_rule

Обновить существующее автоматическое правило.

Параметры
  • evaluation_specstring

    JSON string defining updated rule conditions

  • execution_specstring

    JSON string defining updated rule actions

  • namestring

    New rule name

  • rule_idstringобязательный

    Rule ID

  • schedule_specstring

    JSON string defining updated rule schedule

  • statusstring

    Rule status: ENABLED, DISABLED

upload_feed

Загрузить/запустить загрузку файла товарного фида.

Параметры
  • feed_idstringобязательный

    Product feed ID

  • urlstringобязательный

    URL of the feed file to upload

upload_image

Загружает изображение для рекламы из публичного URL или локального файла. Возвращает хеш изображения для использования в рекламных креативах. Примечание: загрузка из URL требует, чтобы приложение имело возможность Meta URL-fetch, если это приводит к ошибке OAuthException 'Application does not have the capability to make this API call', используйте file_path для загрузки сырых байтов, для чего эта возможность не требуется.

Параметры
  • account_idstring

    Ad account ID to upload into (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • file_pathstring

    Local filesystem path of the image to upload. Sent as base64-encoded bytes, bypassing Meta's URL-fetch capability requirement.

  • namestring

    Name to assign to the uploaded image. Defaults to the file_path basename when uploading a local file.

  • urlstring

    Public URL of the image to upload

upload_video

Загружает рекламное видео из публичного URL или локального файла. Возвращает ID видео для использования в рекламных креативах.

Параметры
  • account_idstring

    Ad account ID to upload into (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.

  • descriptionstring

    Video description

  • file_pathstring

    Local filesystem path of the video to upload. Sent as multipart/form-data, bypassing the need for a publicly reachable URL.

  • file_urlstring

    Public URL of the video to upload

  • titlestring

    Video title

Похожие MCP-сервера

marketplaceadpros/amazon-ads-mcp-server

marketplaceadpros/amazon-ads-mcp-server

Сервер для подключения к Amazon Advertising через MarketplaceAdPros. Управляйте рекламными кампаниями, группами объявлений, ключевыми словами и отчётами на естественном языке. Полезен маркетологам ...

JavaScript⭐ 29
damientilman/mailchimp-mcp-server

damientilman/mailchimp-mcp-server

MCP-сервер для Mailchimp Marketing API с 115 инструментами: управление кампаниями, A/B-тестами, отчётами, аудиториями, лендингами, e-commerce. Есть безопасные режимы read-only и dry-run. Идеально д...

Python⭐ 24
paracetamol951/caisse-enregistreuse-mcp-server

paracetamol951/caisse-enregistreuse-mcp-server

Kash MCP сервер подключает ваш бизнес к ИИ-ассистентам. Управляйте POS, CRM и каталогом через чат с Claude или ChatGPT. Автоматизируйте продажи, заказы, клиентов и отчёты без лишних кликов.

TypeScript⭐ 2
mambalabsdev/mcp-icp-fit-scorer

mambalabsdev/mcp-icp-fit-scorer

ICP Fit Scorer оценивает соответствие компании вашему идеальному профилю клиента (ICP) по весовым сигналам — найм, техстек, размер. Выдаёт балл 0-100, уровень A-D и разбивку. Готовит плоскую строку...

TypeScript⭐ 2
sergehuber/inoyu-mcp-unomi-server

sergehuber/inoyu-mcp-unomi-server

MCP сервер для интеграции Claude с Apache Unomi: управление пользовательскими профилями, контекстом и согласиями (consent) с поддержкой GDPR. Автоматический поиск профилей по email, управление сесс...

JavaScript⭐ 10
square/square-mcp-server

square/square-mcp-server

MCP сервер для подключения ИИ-помощников к Square Connect API. Управляйте платежами, заказами, каталогом и клиентами Square напрямую через AI. Упрощает автоматизацию бизнес-операций.

TypeScript⭐ 108
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин