Bing Webmaster CLI

Bing Webmaster CLI Skill

Use this skill to operate and troubleshoot the bwm CLI in this repository.

When To Use

Use this skill when the task involves any of:

• creating or rotating a Bing Webmaster API key
• authenticating this CLI with env var or local stored key
• listing sites in Bing Webmaster
• fetching site/URL traffic stats
• checking whether a URL is indexed and why not
• submitting URLs for indexing

Prerequisites

• Python environment with this project installed (bwm command available)
• Bing Webmaster Tools account with access to at least one site
• Bing Webmaster API key

Install This CLI

Recommended (pipx, global bwm command):

python3 -m pip install --user pipx
python3 -m pipx ensurepath
pipx install bing-webmaster-cli
bwm --version

From source (development):

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
bwm --help

From source (pipx, editable):

pipx install -e /absolute/path/to/bing_webmaster_cli
bwm --help

Create API Key (Bing Webmaster)

As of February 26, 2026, create a Bing Webmaster API key using these steps:

1. Open Bing Webmaster Tools: https://www.bing.com/webmasters/
2. Sign in and open account/API access settings.
3. Generate a new API key.
4. Copy and securely store the key.

Reference:

• https://learn.microsoft.com/en-us/bingwebmaster/getting-access

Authenticate This CLI

Environment variable (recommended for CI/ephemeral usage)

export BING_WEBMASTER_API_KEY="<your_api_key>"
bwm auth whoami

Local stored key

bwm auth login --api-key "<your_api_key>"
bwm auth whoami

Interactive prompt:

bwm auth login

Clear local key:

bwm auth clear

Optional: Set Default Site

bwm config set default-site https://example.com/
bwm config get default-site

When set, commands that accept --site can omit it.

Command Reference

Top-level:

• bwm --version
• bwm --help

auth

• bwm auth login [--api-key TEXT]
• bwm auth whoami [--output table|json]
• bwm auth clear

config

• bwm config set default-site SITE_URL
• bwm config get default-site

site

• bwm site list [--output table|json|csv] [--csv-path FILE]

stats

• bwm stats site [--site SITE] [--start-date YYYY-MM-DD] [--end-date YYYY-MM-DD] [--output table|json|csv] [--csv-path FILE]
• bwm stats url [--site SITE] --url URL [--start-date YYYY-MM-DD] [--end-date YYYY-MM-DD] [--output table|json|csv] [--csv-path FILE]

url

• bwm url check-index [--site SITE] --url URL [--output table|json] [--explain]
• bwm url submit [--site SITE] [--url URL]... [--file FILE] [--output table|json]

Quick Examples

# List sites
bwm site list --output json

# Site stats for a date window
bwm stats site \
  --site https://example.com/ \
  --start-date 2026-02-01 \
  --end-date 2026-02-26

# URL stats
bwm stats url \
  --site https://example.com/ \
  --url https://example.com/page \
  --output json

# URL index check with richer explanation
bwm url check-index \
  --site https://example.com/ \
  --url https://example.com/page \
  --output json \
  --explain

# Submit one URL
bwm url submit --site https://example.com/ --url https://example.com/new-page

# Submit batch from file
bwm url submit --site https://example.com/ --file ./urls.txt

Troubleshooting

• Auth error: No API key found...

  • set BING_WEBMASTER_API_KEY or run bwm auth login.

• No site specified. Pass --site or set one...

  • pass --site or set default site with bwm config set default-site ....

• URL appears blocked in Bing UI while simple API fields are sparse

  • run bwm url check-index --explain ... to get best-effort diagnostics from API signals.

Config Paths And Overrides

Defaults:

• credentials: ~/.config/bing-webmaster-cli/credentials.json
• app config: ~/.config/bing-webmaster-cli/config.json

Env overrides:

• BING_WEBMASTER_API_KEY
• BWM_CONFIG_DIR
• BWM_CREDENTIALS_FILE
• BWM_APP_CONFIG_FILE
• BWM_API_BASE_URL