Bing Webmaster Tools (SEO)

Connect your Bing Webmaster Tools account to give the agent real SEO data. The tool does two distinct things: keyword research for any term (no site needed), and reporting on your own verified site(s). One configuration holds the API key (and an optional default site); the agent picks an action per call.

Keyword research (any keyword, no site required)

keyword_stats returns the historical Bing search-impression volume for a keyword in a given country/language — useful for picking topics and validating demand. This works the moment you add an API key.

Your site's own data (requires a verified site)

Once your site is verified in Bing Webmaster Tools, the agent can pull:

• Ranking queries (query_stats) — the actual searches bringing you impressions/clicks, with average position.
• Top pages (page_stats) and traffic over time (rank_and_traffic).
• Crawl health (crawl_stats) and crawl issues (crawl_issues) — index coverage, error codes, blocked URLs, problems to fix.
• Inbound links (link_counts).
• Verified sites (list_sites) — discover which sites are available.

Configuration

• API Key (required) — your Bing Webmaster Tools API key. Stored encrypted and never shown again; on edit, leave it blank to keep the stored key.
• Site URL (optional) — a site verified in your account, e.g. https://example.com/. When set, the site-data actions default to it; when blank, the agent supplies a site per call (and can discover them with list_sites). Keyword research never uses this field.

Setup

1. Go to bing.com/webmasters and sign in; add and verify your site if you haven't (DNS, file, or meta-tag verification).
2. Open Settings → API Access → API Key and copy the key.
3. Paste it into the API Key field. Optionally paste your verified site's URL — exactly as shown in Bing Webmaster, including the trailing slash — into Site URL to default the site-data actions to it.

Action reference

• keyword_stats — needs q, country (e.g. us), language (e.g. en-US). Returns search-impression volume over time: {Query, Date, Impressions, BroadImpressions}.
• list_sites — no input. Returns verified sites: {Url, IsVerified, …}.
• query_stats — a verified site. Returns the queries it ranks for: {Query, Date, Clicks, Impressions, AvgClickPosition, AvgImpressionPosition}.
• page_stats — a verified site. Per-page performance (same metric shape).
• rank_and_traffic — a verified site. Overall {Date, Clicks, Impressions} over time.
• crawl_stats — a verified site. Crawl/index health: {Date, CrawledPages, InIndex, CrawlErrors, Code2xx/301/302/4xx/5xx, BlockedByRobotsTxt, DnsFailures, …}.
• crawl_issues — a verified site. Concrete problems: {Url, HttpCode, Issues, InLinks}.
• link_counts — a verified site. Inbound-link summary: {Links, TotalPages}.

All responses come back cleaned — ISO dates, no internal type fields.

Behaviors & gotchas

• Site resolution — site-data actions use the config Site URL if set; otherwise a site the agent supplies; otherwise they return a clear "specify a site or call list_sites" error. keyword_stats / list_sites never need a site.
• Auth is internal — the key is sent by the backend; you just see a normal API-key field.
• Dates are normalised to YYYY-MM-DD (Bing's raw API uses an awkward internal format).
• Empty results can simply mean no data for that query/site/period.

Good fit for

SEO Analyst, Content Writer, Ad Copywriter, and similar roles — keyword research plus auditing your own site's search performance.

Classification & lifecycle

The tool is read-only, so the destructive / sends-data-externally classification flags don't apply (they ship unset). It's post-call-hook eligible.