Для чего этот сервер?

Сервер превращает сотню операций с рекламными кампаниями Facebook и Instagram в один инструмент для ассистента. Вместо того чтобы вручную долбиться в API, писать парсеры и скрипты — можно просто попросить ИИ создать кампанию, подтянуть статистику или приостановить неэффективные объявления. Разработчикам и маркетологам это экономит часы рутины: всё управление рекламой через диалог.

Что он умеет?

Управляет рекламными кампаниями Facebook и Instagram — создаёт, копирует, обновляет и удаляет кампании, группы и объявления, настраивает креативы, загружает изображения и видео. Работает с аудиториями: кастомные, lookalike, поиск таргетинговых опций, оценка охвата. Собирает инсайты и асинхронные отчёты, управляет лидами и формами, каталогами продуктов, автоматическими правилами, A/B тестами. Отправляет события через Conversions API, управляет аккаунтом и бизнесом, токенами доступа, ищет объявления в библиотеке Meta.

mikusnuz/meta-ads-mcp — MCP-сервер

add_business_user

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

Параметры

emailstringобязательный
Email address of the user to add
roleenumобязательный
Role for the new user
ADMINEMPLOYEE

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.

Параметры

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, ...}}
allow_upsertboolean
Allow UPDATE to create items if they don't exist (default false)

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
namestring
Name for the copied ad set
statusstring
Status for copied ad set (default PAUSED)
deep_copyboolean
Copy ads within the ad set (default true)

copy_campaign

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

Параметры

campaign_idstringобязательный
Source campaign ID to copy
namestring
Name for the copied campaign. Defaults to 'Copy of <original>'
statusstring
Status for copied campaign (default PAUSED)
deep_copyboolean
Copy ad sets and ads within the campaign (default true)

create_ad

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

Параметры

namestringобязательный
Ad name
adset_idstringобязательный
Parent ad set ID
creativestringобязательный
JSON string of creative spec (object_story_spec with page_id, link_data/photo_data/video_data)
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.

Параметры

namestringобязательный
Ad set name
campaign_idstringобязательный
Parent campaign ID
daily_budgetstring
Daily budget in currency cents (e.g. '5000' = $50.00)
lifetime_budgetstring
Lifetime budget in currency cents
optimization_goalstringобязательный
Optimization goal: IMPRESSIONS, REACH, LINK_CLICKS, LANDING_PAGE_VIEWS, OFFSITE_CONVERSIONS, APP_INSTALLS, LEAD_GENERATION, VALUE, THRUPLAY, ENGAGED_USERS
billing_eventstringобязательный
Billing event: IMPRESSIONS, LINK_CLICKS, APP_INSTALLS, THRUPLAY
bid_strategystring
Bid strategy: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS
targetingstringобязательный
JSON string of targeting spec (age_min, age_max, genders, geo_locations, interests, etc.)
start_timestring
Start time (ISO 8601)
end_timestring
End time (ISO 8601)
statusstring
Ad set status (default PAUSED)

create_async_report

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

Параметры

fieldsstring
Comma-separated insight fields
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
time_rangestring
JSON string {since,until} in YYYY-MM-DD format
time_incrementstring
Time granularity: all_days, 1, 7, monthly
filteringstring
JSON string for filtering
levelstring
Aggregation level: campaign, adset, ad

create_block_list

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

Параметры

namestringобязательный
Name for the block list

create_budget_schedule

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

Параметры

budget_valuestringобязательный
Budget amount in account currency cents
budget_value_typestringобязательный
Budget value type (e.g. ABSOLUTE, MULTIPLIER)
time_startstringобязательный
Schedule start time (ISO 8601 or Unix timestamp)
time_endstringобязательный
Schedule end time (ISO 8601 or Unix timestamp)

create_campaign

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

Параметры

namestringобязательный
Campaign name
objectiveenumобязательный
Campaign objective
OUTCOME_AWARENESSOUTCOME_ENGAGEMENTOUTCOME_LEADSOUTCOME_SALESOUTCOME_TRAFFICOUTCOME_APP_PROMOTION
statusstring
Campaign status (default PAUSED)
daily_budgetstring
Daily budget in account currency cents (e.g. '5000' = $50.00)
lifetime_budgetstring
Lifetime budget in account currency cents
special_ad_categoriesstring
JSON array of special ad categories: CREDIT, EMPLOYMENT, HOUSING, ISSUES_ELECTIONS_POLITICS
start_timestring
Campaign start time (ISO 8601 format)
stop_timestring
Campaign stop time (ISO 8601 format)

create_canvas

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

Параметры

page_idstringобязательный
Facebook Page ID to create the canvas on
body_elementsstringобязательный
JSON array of canvas body elements (buttons, carousels, photos, videos, text, etc.)
namestring
Canvas name

create_catalog

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

Параметры

namestringобязательный
Catalog name
verticalstring
Catalog vertical: commerce, hotels, flights, destinations, home_listings, vehicles

create_creative

Создайте новый креатив объявления с помощью object_story_spec. Спецификация определяет содержимое объявления (ссылку, фото или видео) и связанную страницу Facebook.

Параметры

namestringобязательный
Creative name
object_story_specstringобязательный
JSON string of object_story_spec (page_id, link_data/photo_data/video_data)
url_tagsstring
URL tags to append to all links
asset_feed_specstring
JSON string of asset_feed_spec for dynamic creative

create_custom_audience

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

Параметры

namestringобязательный
Audience name
subtypeenumобязательный
Audience subtype
CUSTOMWEBSITEAPPOFFLINE_CONVERSIONCLAIMPARTNERMANAGEDVIDEOLOOKALIKEENGAGEMENTBAG_OF_ACCOUNTSSTUDY_RULE_AUDIENCEFOX
descriptionstring
Audience description
customer_file_sourcestring
Source of customer file: USER_PROVIDED_ONLY, PARTNER_PROVIDED_ONLY, BOTH_USER_AND_PARTNER_PROVIDED

create_dynamic_creative

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

Параметры

namestringобязательный
Creative name
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

create_experiment

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

Параметры

namestringобязательный
Experiment name
descriptionstring
Experiment description
start_timestringобязательный
Start time in ISO 8601 or Unix timestamp
end_timestringобязательный
End time in ISO 8601 or Unix timestamp
typestring
Study type
cellsstringобязательный
JSON array of test cells: [{name, campaign_id}]

create_feed

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

Параметры

catalog_idstringобязательный
Product catalog ID
namestringобязательный
Feed name
schedulestring
JSON string for feed schedule configuration
file_urlstring
URL of the feed file

create_lead_form

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

Параметры

page_idstringобязательный
Facebook Page ID
namestringобязательный
Lead form name
questionsstringобязательный
JSON array of questions. Each: {key: string, type: 'CUSTOM'|'EMAIL'|'PHONE'|'FULL_NAME'|'CITY'|'STATE'|'COUNTRY'|'ZIP'|'JOB_TITLE'|'COMPANY_NAME', label?: string}
privacy_policy_urlstringобязательный
URL to privacy policy
follow_up_action_urlstring
URL to redirect after submission
thank_you_pagestring
JSON object: {title: string, body: string, button_text?: string, button_type?: 'VIEW_WEBSITE'|'DOWNLOAD'}

create_lookalike_audience

Создайте lookalike аудиторию на основе существующей пользовательской аудитории. Коэффициент (1-10) определяет, насколько новая аудитория будет похожа на исходную.

Параметры

namestringобязательный
Lookalike audience name
origin_audience_idstringобязательный
Source custom audience ID
lookalike_specstringобязательный
JSON string: {country: 'US', ratio: 0.01-0.10} where ratio is the lookalike percentage (1%-10%)

create_offline_event_set

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

Параметры

namestringобязательный
Event set name
descriptionstring
Event set description

create_product_set

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

Параметры

catalog_idstringобязательный
Product catalog ID
namestringобязательный
Product set name
filterstring
JSON string of filter rules for the product set

create_rf_prediction

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

Параметры

target_specstringобязательный
JSON string of targeting specification
start_timestringобязательный
Prediction start time (ISO 8601 or Unix timestamp)
stop_timestringобязательный
Prediction stop time (ISO 8601 or Unix timestamp)
budgetnumberобязательный
Budget in account currency cents
frequency_capnumberобязательный
Maximum frequency cap per user
destination_idstringобязательный
Destination ID (e.g. Facebook Page ID)

create_rule

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

Параметры

namestringобязательный
Rule name
evaluation_specstringобязательный
JSON string defining rule conditions
execution_specstringобязательный
JSON string defining rule actions
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
ADMINEMPLOYEE

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

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

Параметры

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

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

Параметры

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

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

get_account_insights

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

Параметры

fieldsstring
Comma-separated insight fields
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
time_rangestring
JSON string {since,until} in YYYY-MM-DD format
time_incrementstring
Time granularity: all_days, 1, 7, monthly
filteringstring
JSON string for filtering
levelstring
Aggregation level: campaign, adset, ad

get_ad

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

Параметры

ad_idstringобязательный
Ad ID
fieldsstring
Comma-separated fields to return

get_ad_account

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

Параметры

fieldsstring
Comma-separated fields to return

get_ad_insights

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

Параметры

ad_idstringобязательный
Ad ID
fieldsstring
Comma-separated insight fields
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
time_rangestring
JSON string {since,until} in YYYY-MM-DD format
time_incrementstring
Time granularity: all_days, 1, 7, monthly
filteringstring
JSON string for filtering
levelstring
Aggregation level: campaign, adset, ad

get_ad_preview

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

Параметры

ad_idstringобязательный
Ad ID
ad_formatstringобязательный
Ad format: DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, INSTAGRAM_STORY, RIGHT_COLUMN_STANDARD, etc.

get_adset

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

Параметры

adset_idstringобязательный
Ad set ID
fieldsstring
Comma-separated fields to return

get_adset_ads

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

Параметры

adset_idstringобязательный
Ad set ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

get_adset_insights

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

Параметры

adset_idstringобязательный
Ad Set ID
fieldsstring
Comma-separated insight fields
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
time_rangestring
JSON string {since,until} in YYYY-MM-DD format
time_incrementstring
Time granularity: all_days, 1, 7, monthly
filteringstring
JSON string for filtering
levelstring
Aggregation level: campaign, adset, ad

get_adset_leads

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

Параметры

adset_idstringобязательный
Ad set ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

get_adset_targeting_sentence

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

Параметры

adset_idstringобязательный
Ad set ID

get_async_report

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

Параметры

report_run_idstringобязательный
Report run ID from create_async_report
fieldsstring
Comma-separated fields to return

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

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

Параметры

campaign_idstringобязательный
Campaign ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

get_campaign_adsets

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

Параметры

campaign_idstringобязательный
Campaign ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

get_campaign_insights

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

Параметры

campaign_idstringобязательный
Campaign ID
fieldsstring
Comma-separated insight fields
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
time_rangestring
JSON string {since,until} in YYYY-MM-DD format
time_incrementstring
Time granularity: all_days, 1, 7, monthly
filteringstring
JSON string for filtering
levelstring
Aggregation level: campaign, adset, ad

get_campaign_leads

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

Параметры

campaign_idstringобязательный
Campaign ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

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

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

Параметры

ad_idstringобязательный
Ad 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

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

Параметры

feed_idstringобязательный
Product feed ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

get_form_leads

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

Параметры

form_idstringобязательный
Lead form ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

get_image

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

Параметры

image_idstringобязательный
Image ID
fieldsstring
Comma-separated fields to return

get_lead

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

Параметры

lead_idstringобязательный
Lead ID
fieldsstring
Comma-separated fields to return

get_lead_form

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

Параметры

form_idstringобязательный
Lead form ID
fieldsstring
Comma-separated fields to return

get_product

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

Параметры

product_idstringобязательный
Product ID
fieldsstring
Comma-separated fields to return

get_product_set

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

Параметры

set_idstringобязательный
Product set ID
fieldsstring
Comma-separated fields to return

get_reach_estimate

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

Параметры

targeting_specstringобязательный
JSON string of targeting spec (same format as ad set targeting)

get_rf_prediction

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

Параметры

prediction_idstringобязательный
Prediction ID
fieldsstring
Comma-separated fields to return

get_rule

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

Параметры

rule_idstringобязательный
Rule ID
fieldsstring
Comma-separated fields to return

get_saved_audience

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

Параметры

audience_idstringобязательный
Saved audience ID
fieldsstring
Comma-separated fields to return

get_targeting_suggestions

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

Параметры

targeting_liststringобязательный
JSON string of current targeting criteria to get suggestions for

get_video

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

Параметры

video_idstringобязательный
Video ID
fieldsstring
Comma-separated fields to return

list_account_users

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_ad_accounts

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_ads

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

Параметры

campaign_idstring
Filter by campaign ID
adset_idstring
Filter by ad set ID
statusstring
Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_adsets

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

Параметры

campaign_idstring
Filter by campaign ID
statusstring
Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_block_lists

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_budget_schedules

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_business_ad_accounts

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_businesses

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_business_instagram_accounts

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_business_pages

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_business_users

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_campaigns

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

Параметры

statusstring
Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED
objectivestring
Filter by objective: OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, OUTCOME_APP_PROMOTION
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page
beforestring
Pagination cursor for previous page

list_canvases

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_catalogs

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_creatives

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_custom_audiences

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_experiments

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_feeds

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

Параметры

catalog_idstringобязательный
Product catalog ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_images

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_lead_forms

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

Параметры

page_idstringобязательный
Facebook Page ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_offline_event_sets

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_products

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

Параметры

catalog_idstringобязательный
Product catalog ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page
filterstring
JSON string of filter rules

list_product_sets

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

Параметры

catalog_idstringобязательный
Product catalog ID
fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_rf_predictions

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_rules

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results to return
afterstring
Pagination cursor for next page

list_saved_audiences

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_system_users

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

list_videos

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

Параметры

fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page

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. Поддерживает поиск по ключевым словам, странам и типу объявлений. Полезен для конкурентного анализа и прозрачности.

Параметры

search_termsstringобязательный
Keywords to search for in ads
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.
fieldsstring
Comma-separated fields to return
limitnumber
Number of results (default 25)
afterstring
Pagination cursor for next page
order_bystring
Sort order for results

search_locations

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

Параметры

qstringобязательный
Search query (e.g. 'New York', 'California', 'United States')
location_typesstring
Comma-separated location types: country, region, city, zip, geo_market, electoral_district
limitnumber
Number of results (default 25)

search_targeting

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

Параметры

qstringобязательный
Search query (e.g. 'fitness', 'technology', 'cooking')
typestring
Targeting type filter: adinterest, adgeolocation, adeducationschool, adeducationmajor, adworkemployer, adworkposition, adlocale, etc.
limitnumber
Number of results (default 25)

search_targeting_map

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

Параметры

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

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

Параметры

event_set_idstringобязательный
Offline event set ID
eventsstringобязательный
JSON array of offline events

update_ad

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

Параметры

ad_idstringобязательный
Ad ID to update
namestring
New ad name
statusstring
New status: ACTIVE, PAUSED, DELETED, ARCHIVED
creativestring
New creative spec as JSON string
tracking_specsstring
New tracking specs as JSON string

update_ad_account

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

Параметры

namestring
New account name
timezone_namestring
New timezone (e.g. 'America/New_York')
spend_capstring
Account spend cap in currency cents (e.g. '100000' = $1000.00)

update_adset

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

Параметры

adset_idstringобязательный
Ad set ID to update
namestring
New ad set name
statusstring
New status: ACTIVE, PAUSED, DELETED, ARCHIVED
daily_budgetstring
New daily budget in currency cents
lifetime_budgetstring
New lifetime budget in currency cents
targetingstring
New targeting spec as JSON string
start_timestring
New start time (ISO 8601)
end_timestring
New end time (ISO 8601)
bid_amountstring
New bid amount in currency cents

update_audience

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

Параметры

audience_idstringобязательный
Audience ID to update
namestring
New audience name
descriptionstring
New audience description

update_budget_schedule

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

Параметры

schedule_idstringобязательный
Budget schedule ID to update
budget_valuestring
New budget amount in account currency cents
time_startstring
New schedule start time
time_endstring
New schedule end time

update_campaign

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

Параметры

campaign_idstringобязательный
Campaign ID to update
namestring
New campaign name
statusstring
New status: ACTIVE, PAUSED, DELETED, ARCHIVED
daily_budgetstring
New daily budget in currency cents
lifetime_budgetstring
New lifetime budget in currency cents
start_timestring
New start time (ISO 8601)
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

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

Параметры

experiment_idstringобязательный
Experiment (ad study) ID
namestring
New experiment name
descriptionstring
New experiment description

update_product

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

Параметры

product_idstringобязательный
Product ID
namestring
Product name
descriptionstring
Product description
pricestring
Product price (e.g. '9.99 USD')
urlstring
Product URL
image_urlstring
Product image URL
availabilitystring
Product availability: in stock, out of stock, etc.

update_product_set

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

Параметры

set_idstringобязательный
Product set ID
namestring
New product set name
filterstring
JSON string of updated filter rules

update_rule

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

Параметры

rule_idstringобязательный
Rule ID
namestring
New rule name
evaluation_specstring
JSON string defining updated rule conditions
execution_specstring
JSON string defining updated rule actions
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. Возвращает хэш изображения для использования в рекламных креативах.

Параметры

urlstringобязательный
Public URL of the image to upload

upload_video

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

Параметры

file_urlstringобязательный
Public URL of the video to upload
titlestring
Video title
descriptionstring
Video description

mikusnuz/meta-ads-mcp

meta-ads-mcp

When to Use

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры

Параметры