Pp Bing Webmaster

Bing Webmaster Tools — Printing Press CLI

publish plan is the read-only live planner (sitemap + quota); it never accepts --confirm. Existing publish --confirm is a separate mutating path and is not live-submission-verified. Missing or exhausted quota now fails closed or produces a zero-submission plan.

Compatibility: sites moves, deeplinks get, and deeplinks algo-urls are not supported. The first returned persistent live HTTP 404; the latter two return provider Deprecated errors. Live gap acceptance uses real Bing responses and an explicitly synthetic local GSC CSV fixture, not real Google account data.

Prerequisites: Install the CLI

This skill drives the bing-webmaster-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   bashCopy code
   npx -y @mvanhorn/printing-press-library install bing-webmaster --cli-only
   

2. Verify: bing-webmaster-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

bashCopy code
go install github.com/mvanhorn/printing-press-library/library/developer-tools/bing-webmaster/cmd/bing-webmaster-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

The most complete Bing Webmaster CLI: all 60 documented API methods as composable commands, with offline FTS search, read-only SQL, and agent-native output. On top of raw endpoints it layers what SEOs actually need — review for weekly query deltas, drift for ranking movement, publish for quota-paced bulk indexing, triage for crawl-error prioritization, and gap to reconcile Bing against Google Search Console.

When to Use This CLI

Use this CLI when an agent or SEO needs to manage Bing indexing programmatically: reviewing weekly query performance, detecting ranking drift, bulk-submitting URLs within quota, triaging crawl errors, monitoring sitemap health, or comparing Bing coverage against Google. It is the right tool whenever the task involves Bing Webmaster data and you want composable JSON output plus local history rather than clicking through the web UI.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• review — See which Bing queries you gained or lost, and how CTR and average position shifted, vs the previous period — not just a raw snapshot.

  Reach for this for a weekly SEO standup instead of eyeballing raw GetQueryStats; it tells the agent what actually changed.

  bashCopy code
  bing-webmaster-pp-cli review --site https://example.com --days 7 --agent
  

• drift — Track average-position movement per query and page over time and surface the biggest climbers and droppers.

  Use when an agent must explain why traffic moved — drift points at the exact queries/pages that re-ranked.

  bashCopy code
  bing-webmaster-pp-cli drift --site https://example.com --top 20 --agent
  

• feed-health — Track submitted, discovered, and indexed counts for each feed over time and flag drops.

  Use to catch a sitemap that silently stopped being indexed before it tanks traffic.

  bashCopy code
  bing-webmaster-pp-cli feed-health --site https://example.com --agent
  

• watch — Diff the latest sync against the previous one and surface indexation, crawl, and impression regressions per site.

  Run after each scheduled sync so the agent gets a single 'what regressed' digest instead of re-reading everything.

  bashCopy code
  bing-webmaster-pp-cli watch --site https://example.com --agent
  

Operational triage

• triage — Categorize crawl issues by severity, diff them against your last sync, and map each issue to the affected child URLs in one view.

  Use to turn a raw GetCrawlIssues dump into a prioritized, what-changed-since-last-time worklist.

  bashCopy code
  bing-webmaster-pp-cli triage --site https://example.com --agent
  

Submission at scale

• quota — One view of URL and content submission quota — daily and monthly remaining — plus a pacing recommendation.

  Check before any bulk submission so the agent knows how many URLs it can push today without hitting the wall.

  bashCopy code
  bing-webmaster-pp-cli quota --site https://example.com --agent
  

Cross-engine intelligence

• gap — Reconcile your Bing query/page performance against a Google Search Console export to find queries and pages you rank for on one engine but not the other.

  Use to find low-effort wins: pages already strong on Google that are missing from Bing (and vice-versa).

  bashCopy code
  bing-webmaster-pp-cli gap --site https://example.com --gsc ./gsc-queries.csv --agent
  

Command Reference

blocked — Block URLs from the index and manage page-preview blocks

• bing-webmaster-pp-cli blocked add — Block a page or directory from the index
• bing-webmaster-pp-cli blocked add-preview-block — Block the page preview for a URL
• bing-webmaster-pp-cli blocked list — List blocked pages and directories
• bing-webmaster-pp-cli blocked preview-blocks — List active page-preview blocks
• bing-webmaster-pp-cli blocked remove — Unblock a previously blocked page or directory
• bing-webmaster-pp-cli blocked remove-preview-block — Remove a page-preview block

crawl — Read crawl stats and issues, and manage crawl settings

• bing-webmaster-pp-cli crawl children-info — Index details for the pages under a directory
• bing-webmaster-pp-cli crawl issues — Crawl issues found for a site
• bing-webmaster-pp-cli crawl save-settings — Save crawl settings for a site
• bing-webmaster-pp-cli crawl settings — Get crawl settings for a site
• bing-webmaster-pp-cli crawl stats — Daily crawl statistics for a site
• bing-webmaster-pp-cli crawl url-info — Index details for a single page

deeplinks — Deep link blocks (several get/update methods are obsolete in the Bing API)

• bing-webmaster-pp-cli deeplinks add-block — Block a deep link
• bing-webmaster-pp-cli deeplinks blocks — List deep link blocks for a site
• bing-webmaster-pp-cli deeplinks remove-block — Remove a deep link block
• bing-webmaster-pp-cli deeplinks update — [OBSOLETE in Bing API] Update a deep link weight

feeds — Manage submitted sitemaps and feeds

• bing-webmaster-pp-cli feeds details — Get details for a feed or sitemap index
• bing-webmaster-pp-cli feeds list — List all top-level feeds (sitemaps) for a site
• bing-webmaster-pp-cli feeds remove — Remove a submitted feed
• bing-webmaster-pp-cli feeds submit — Submit a sitemap or feed URL

geo — Country/region (geo) targeting settings (a feature Google Search Console removed)

• bing-webmaster-pp-cli geo add — Add a country/region targeting setting
• bing-webmaster-pp-cli geo remove — Remove a country/region targeting setting
• bing-webmaster-pp-cli geo settings — List country/region targeting settings

keywords — Keyword research (Bing-unique; takes query/country/language, not a site)

• bing-webmaster-pp-cli keywords get — Keyword impressions for a period
• bing-webmaster-pp-cli keywords related — Keywords related to a query for a period
• bing-webmaster-pp-cli keywords stats — Historical stats for a keyword

links — Inbound link analytics and connected pages

• bing-webmaster-pp-cli links add-connected — Add a connected page to the site
• bing-webmaster-pp-cli links connected — List pages connected to the site
• bing-webmaster-pp-cli links counts — Pages with inbound link counts (paged)
• bing-webmaster-pp-cli links url-links — Inbound links for a specific URL (paged)

params — URL normalization query-parameter rules (a feature Google Search Console removed)

• bing-webmaster-pp-cli params add — Add a query-parameter normalization rule
• bing-webmaster-pp-cli params list — List query-parameter normalization rules
• bing-webmaster-pp-cli params remove — Remove a query-parameter rule
• bing-webmaster-pp-cli params toggle — Enable or disable a query-parameter rule

sites — Manage and inspect the sites your API key controls

• bing-webmaster-pp-cli sites add — Add a new site to your account
• bing-webmaster-pp-cli sites add-role — Delegate site access to another user
• bing-webmaster-pp-cli sites list — List all verified sites for the current user
• bing-webmaster-pp-cli sites remove — Remove a site from your account
• bing-webmaster-pp-cli sites remove-role — Revoke a user's delegated access to a site
• bing-webmaster-pp-cli sites roles — Get delegated user roles for a site
• bing-webmaster-pp-cli sites submit-move — Submit a site migration
• bing-webmaster-pp-cli sites verify — Attempt verification of a site you have added

submission — Submit URLs and content to Bing for indexing, and check quotas

• bing-webmaster-pp-cli submission content-quota — Get content submission quota
• bing-webmaster-pp-cli submission fetch — Request that Bing fetch a single URL
• bing-webmaster-pp-cli submission fetched — List URLs Bing has fetched on request
• bing-webmaster-pp-cli submission fetched-details — Get details of a fetched URL
• bing-webmaster-pp-cli submission submit-batch — Submit up to 500 URLs for indexing in one request
• bing-webmaster-pp-cli submission submit-content — Submit page content directly to Bing
• bing-webmaster-pp-cli submission submit-url — Submit a single URL for indexing
• bing-webmaster-pp-cli submission url-quota — Get daily and monthly URL submission quota

traffic — Read query, page, and ranking/traffic statistics

• bing-webmaster-pp-cli traffic children-traffic — Index and traffic info for the pages under a directory
• bing-webmaster-pp-cli traffic page-queries — Queries that lead to a given page
• bing-webmaster-pp-cli traffic pages — Top pages for a site
• bing-webmaster-pp-cli traffic queries — Top query stats for a site (may be empty below Bing's data threshold)
• bing-webmaster-pp-cli traffic query-page-detail — Detailed stats for a specific query and page pair
• bing-webmaster-pp-cli traffic query-pages — Pages that rank for a given query
• bing-webmaster-pp-cli traffic query-traffic — Traffic stats for a single query
• bing-webmaster-pp-cli traffic rank-traffic — Daily impressions and clicks for a site
• bing-webmaster-pp-cli traffic url-traffic — Index and traffic info for a single page

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

bashCopy code
bing-webmaster-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Weekly query review, agent-friendly

bashCopy code
bing-webmaster-pp-cli review --site https://example.com --days 7 --agent --select gained,lost,position_delta

Returns only the changed-query summary fields so an agent doesn't parse the full stats payload.

Quota-paced sitemap submission (dry run first)

bashCopy code
bing-webmaster-pp-cli publish --site https://example.com --from-sitemap https://example.com/sitemap.xml --dry-run

Shows exactly which URLs would be submitted, chunked to 500 and capped at remaining quota, before sending anything.

Crawl-error triage since last sync

bashCopy code
bing-webmaster-pp-cli triage --site https://example.com --agent

Prioritized, deduped crawl issues with affected URLs — a worklist, not a raw dump.

Find Bing gaps vs Google

bashCopy code
bing-webmaster-pp-cli gap --site https://example.com --gsc ./gsc-queries.csv --agent

Joins a GSC performance export with Bing stats to surface cross-engine ranking gaps.

Auth Setup

Authentication uses a single Bing Webmaster API key passed as the apikey query parameter. The key is per-user (it covers every site you've verified), not per-site. Get it at bing.com/webmasters → Settings → API Access → Generate API Key, then set it as the BING_WEBMASTER_API_KEY environment variable. Run doctor to confirm the key is valid and the API is reachable.

Run bing-webmaster-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  bashCopy code
  bing-webmaster-pp-cli blocked list --site https://example.com/resource --agent --select id,name,status
  

• Previewable — --dry-run shows the request without sending

• Offline-friendly — sync/search commands can use the local SQLite store when available

• Non-interactive — never prompts, every input is a flag

• Explicit retries — use --idempotent only when an already-existing create should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

jsonCopy code
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

Copy code
bing-webmaster-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
bing-webmaster-pp-cli feedback --stdin < notes.txt
bing-webmaster-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.bing-webmaster-pp-cli/feedback.jsonl. They are never POSTed unless BING_WEBMASTER_FEEDBACK_ENDPOINT is set AND either --send is passed or BING_WEBMASTER_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

Copy code
bing-webmaster-pp-cli profile save briefing --json
bing-webmaster-pp-cli --profile briefing blocked list --site https://example.com/resource
bing-webmaster-pp-cli profile list --json
bing-webmaster-pp-cli profile show briefing
bing-webmaster-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

Argument Parsing

Parse $ARGUMENTS:

1. Empty, help, or --help → show bing-webmaster-pp-cli --help output
2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

1. Install the MCP server:

   bashCopy code
   go install github.com/mvanhorn/printing-press-library/library/developer-tools/bing-webmaster/cmd/bing-webmaster-pp-mcp@latest
   

2. Register with Claude Code:

   bashCopy code
   claude mcp add bing-webmaster-pp-mcp -- bing-webmaster-pp-mcp
   

3. Verify: claude mcp list

Direct Use

1. Check if installed: which bing-webmaster-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
3. Execute with the --agent flag:

   bashCopy code
   bing-webmaster-pp-cli <command> [subcommand] [args] --agent
   

4. If ambiguous, drill into subcommand help: bing-webmaster-pp-cli <command> --help.