SearchAds Manager bevat een lokale MCP-server uitsluitend voor macOS, die binnen de app draait en de Apple Search Ads-inloggegevens hergebruikt die al in je accountinstellingen zijn geconfigureerd.

Wat het doet

• Zoek de apps waarvan je eigenaar bent en de ondersteunde landen op voordat je campagnes maakt.
• Haal campagne-, advertentiegroep- en zoekwoordrapporten op zonder eigen API-scripts te schrijven.
• Maak, wijzig en verwijder campagnes, advertentiegroepen en zoekwoorden vanuit Codex via een lokaal eindpunt met authenticatie.
• Houd de verbinding lokaal op je Mac zolang de app draait.

Uitvoeringsmodel

1. De server luistert uitsluitend op 127.0.0.1.
2. De server is alleen beschikbaar zolang de macOS-app draait.
3. De toegang is beveiligd met een gegenereerd token dat in de appinstellingen wordt opgeslagen.
4. Het MCP-eindpunt is /mcp.
5. Een eindpunt voor statuscontroles is beschikbaar op /health.

Instellingen in SearchAds Manager

Het instellingenscherm op macOS bevat een kaart Codex MCP-server met:

1. Een schakelaar om de server in te schakelen
2. Een instelbare TCP-poort
3. Een gegenereerd toegangstoken
4. De volledige MCP-URL met authenticatie
5. Een direct uitvoerbaar Codex-commando
6. Statusinformatie voor de lokale luisterservice

Beschikbare MCP-tools

Verkenning en metadata

• list_apps
• list_supported_countries

Rapportage

• get_campaign_report
• get_adgroup_report
• get_keyword_report

Campagnebeheer

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

Advertentiegroepbeheer

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

Zoekwoordbeheer

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

Gebruikelijke werkwijze

1. Roep list_apps aan om de adam_id te vinden van de app die je wilt promoten.
2. Roep list_supported_countries aan om geldige land- of regiocodes te controleren.
3. Bekijk de huidige prestaties met get_campaign_report, get_adgroup_report of get_keyword_report.
4. Bekijk de huidige toestand met list_campaigns, list_adgroups en list_keywords.
5. Voer schrijfbewerkingen uit in kleine, expliciete batches, zodat fouten makkelijker te begrijpen zijn en wijzigingen zo nodig makkelijker ongedaan te maken zijn.

Volgende stap

Open SearchAds Manager koppelen aan Codex om de server aan Codex toe te voegen en een smoketest met tijdelijke testgegevens uit te voeren.