microsoft-ads-clilisted
Install: claude install-skill almoretti/martech-ai-skills-and-tools
# Microsoft Ads CLI Skill
You have access to `microsoft-ads-cli`, a read-only CLI for the Bing Ads REST API v13. It mirrors `google-ads-cli` 1:1 — same command names and shapes wherever the Bing API allows. Use it to query ad accounts, pull performance stats (parsed to JSON rows), inspect audiences and extensions, and audit UET conversion tracking across Search, Shopping, Audience, DynamicSearchAds, and PerformanceMax campaigns.
## Quick start
```bash
# Check if the CLI is available
microsoft-ads-cli --help
# Verify credentials (authenticated user info)
microsoft-ads-cli user
# List accessible ad accounts
microsoft-ads-cli accounts
```
If the CLI is not installed, install it:
```bash
npm install -g microsoft-ads-cli
```
## Authentication
The CLI uses OAuth2 user credentials plus a Microsoft Advertising **Developer Token**. Credentials are stored in `~/.config/microsoft-ads-cli/credentials.json` with auto-refreshing tokens.
Before running any command, verify credentials by running `microsoft-ads-cli user`. If it fails with a credentials error, ask the user to set up authentication:
```bash
microsoft-ads-cli auth login \
--developer-token=xxx \
--client-id=xxx
```
How to get the values:
1. **developer_token**: [Microsoft Advertising Developer Portal](https://developers.ads.microsoft.com/Account) → request a Developer Token.
2. **client_id**: [Microsoft Entra app registrations](https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)