<div align="center">

# 🅱️ bing-seo-mcp

**The full Bing Webmaster Tools API for AI agents — over one MCP server.**

Sites &amp; verification · URL submission · Sitemaps · Traffic &amp; crawl stats · Keyword research · URL blocking

[![npm version](https://img.shields.io/npm/v/bing-seo-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/bing-seo-mcp)
[![npm downloads](https://img.shields.io/npm/dm/bing-seo-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/bing-seo-mcp)
[![node](https://img.shields.io/node/v/bing-seo-mcp?logo=node.js&logoColor=white)](https://nodejs.org)
[![license](https://img.shields.io/npm/l/bing-seo-mcp?color=blue)](./LICENSE)
[![MCP](https://img.shields.io/badge/Model_Context_Protocol-stdio-6E56CF)](https://modelcontextprotocol.io)

</div>

---

A [Model Context Protocol](https://modelcontextprotocol.io) server that lets Claude (and any MCP client) drive **Bing Webmaster Tools** end to end — manage and verify sites, push URLs for indexing, submit sitemaps, pull traffic / query / crawl stats, research keywords, and block URLs. Auth is a single **API key** — paste it once and you're running.

## ✨ Highlights

- 🌐 **Sites &amp; verification** — list, add, verify, inspect roles
- 📤 **URL submission** — single, batch, full-content, with live quota
- 🗺️ **Sitemaps** — list and submit feeds
- 📈 **Stats** — rank &amp; traffic, queries, pages, crawl stats &amp; issues
- 🔑 **Keyword research** — keyword and related-keyword data
- 🚫 **URL blocking** — block pages/directories and deep links
- 🔐 **One-key auth** — validated on save, stored locally
- 🛡️ **Safety rails** — read-only mode and per-call confirm guards

## 📦 Installation

Run straight from npm with `npx` (no install needed), or build from source:

```bash
# from source
git clone https://github.com/skiddgoddamn/bing-seo-mcp
cd bing-seo-mcp
npm install && npm run build
```

## 🔌 Connect to your MCP client

Add to your MCP config (e.g. `~/.claude.json` or `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "bing-seo": {
      "command": "npx",
      "args": ["-y", "bing-seo-mcp"],
      "env": { "BING_API_KEY": "" }
    }
  }
}
```

<details>
<summary>Or point at a local build</summary>

```json
{
  "mcpServers": {
    "bing-seo": {
      "command": "node",
      "args": ["F:/projects/bing-seo-mcp/build/index.js"]
    }
  }
}
```
</details>

## 🔑 Get your API key

1. Sign in at [Bing Webmaster Tools](https://www.bing.com/webmasters/)
2. Go to **Settings → API access → API Key**
3. Copy the key — set it via the `b_set_apikey` tool or the `BING_API_KEY` env var

## 🚀 Setup flow

| Step | Tool | What happens |
|------|------|--------------|
| 1 | `b_set_apikey` | Save your key — validated against the live API before it's stored |
| 2 | `bing_sites_get` | List your verified sites |
| ✓ | `b_auth_status` | Check whether the key is configured and valid |

## ⚙️ Environment variables

| Variable | Default | Description |
|---|---|---|
| `BING_API_KEY` | — | Fallback API key (a saved key takes precedence) |
| `BING_MCP_CONFIG_DIR` | `~/.bing-seo-mcp` | Override the config directory |
| `B_READONLY` | `false` | Block every mutating tool (`_add` `_submit` `_remove` `_block` `_verify`) |
| `B_CONFIRM` | `false` | Require a `confirm=true` argument on mutating calls |
| `B_LOG_LEVEL` | `INFO` | `DEBUG` · `INFO` · `WARNING` · `ERROR` |
| `B_LOG_BODIES` | `false` | Log request/response bodies to stderr (verbose) |
| `B_LOG_FILE` | — | Append log lines to a file (default: stderr only) |

See [`.env.example`](./.env.example) for a ready-to-copy template.

## 🧰 Tool reference

### 🔐 Auth
| Tool | Description |
|---|---|
| `b_auth_status` | Show whether an API key is configured and valid |
| `b_set_apikey` | Save and validate the Bing Webmaster API key |

### 🌐 Site management
| Tool | Description |
|---|---|
| `bing_sites_get` | List all sites for the authenticated user |
| `bing_site_add` | Add a site to the account |
| `bing_site_verify` | Trigger ownership verification for a site |
| `bing_site_roles` | Get roles/owners of a site |

### 📤 URL submission
| Tool | Description |
|---|---|
| `bing_submit_url` | Submit a single URL for indexing |
| `bing_submit_url_batch` | Submit multiple URLs in one batch |
| `bing_submit_content` | Submit a URL with its full HTTP content |
| `bing_url_quota` | Daily/monthly URL submission quota |

### 🗺️ Sitemaps
| Tool | Description |
|---|---|
| `bing_sitemaps_get` | List submitted sitemaps/feeds for a site |
| `bing_sitemap_submit` | Submit a sitemap/feed URL |

### 📈 Stats &amp; analytics
| Tool | Description |
|---|---|
| `bing_rank_traffic_stats` | Rank and traffic stats for a site |
| `bing_query_stats` | Search query stats for a site |
| `bing_page_stats` | Per-page traffic stats |
| `bing_page_query_stats` | Query stats for a specific page |
| `bing_crawl_stats` | Crawl stats for a site |
| `bing_crawl_issues` | Crawl issues/errors for a site |

### 🔑 Keywords
| Tool | Description |
|---|---|
| `bing_keyword_get` | Impression data for an exact keyword |
| `bing_related_keywords` | Related keywords for a query |

### 🚫 URL blocking
| Tool | Description |
|---|---|
| `bing_blocked_urls_get` | List blocked URLs for a site |
| `bing_block_url_add` | Block a URL or directory from Bing search |
| `bing_block_url_remove` | Remove a URL block |
| `bing_deep_link_block` | Add a deep link block |

## 🛡️ Safety rails

- **`B_READONLY=true`** — blocks every tool whose name contains `_add` `_submit` `_remove` `_block` `_verify`. Reads still work.
- **`B_CONFIRM=true`** — mutating tools return a preview and require a follow-up call with `confirm: true`.

## 📄 License

MIT © [skiddgoddamn](https://github.com/skiddgoddamn)