search-console-mcp 1.10.0 → 1.11.0

package/README.md

@@ -1,7 +1,7 @@
 
-# Google Search Console MCP Server
+# Search Console MCP
 
-A Model Context Protocol (MCP) server that transforms how you interact with Google Search Console. Stop exporting CSVs and start asking questions.
+A Model Context Protocol (MCP) server that transforms how you interact with **Google Search Console** and **Bing Webmaster Tools**. Stop exporting CSVs and start asking questions.
 
 [📚 View Documentation](https://searchconsolemcp.mintlify.app/)
 
@@ -29,7 +29,7 @@ A Model Context Protocol (MCP) server that transforms how you interact with Goog
 
 Copy and paste these into your MCP client (Claude Desktop, etc.) to see the intelligence engine in action:
 
-#### �️ The Traffic Detective
+#### 🔍 The Traffic Detective
 > "My traffic dropped this week compared to last. Use the anomaly detection and time-series tools to find exactly when the drop started and which pages are responsible."
 
 #### 🎯 The "Striking Distance" Hunter
@@ -47,6 +47,9 @@ Copy and paste these into your MCP client (Claude Desktop, etc.) to see the inte
 #### ⚡ The Speed vs. Ranking Correlator
 > "Fetch the top 5 pages by impressions. For these pages, run a PageSpeed audit. Is there any correlation between low performance scores and recently declining positions?"
 
+#### 🔍 Multi-Engine Comparison
+> "Compare my performance between Google and Bing for the last 30 days. Which keywords are ranking better on Bing but have lower traffic on Google?"
+
 ---
 
 ## 🔐 Authentication (Desktop Flow)
@@ -95,6 +98,20 @@ For server-side environments or automated tasks where interactive login isn't po
 
 ---
 
+## 🔑 Bing Webmaster Tools (API Key)
+
+To access Bing data, you simply need an API Key.
+
+### Setup:
+1.  **Get Your API Key**: Go to [Bing Webmaster Tools Settings](https://www.bing.com/webmasters/settings/api).
+2.  **Configure**: Set the API key in your environment:
+    ```bash
+    export BING_API_KEY="your-api-key-here"
+    ```
+3.  **IndexNow**: Bing tools also support **IndexNow** for instant URL submission.
+
+---
+
 
 ## 🛡️ Fort Knox Security
 
@@ -110,7 +127,7 @@ This MCP server implements a multi-layered security architecture:
 
 ## Tools Reference
 
-### Analytics
+### Google Analytics
 | Tool | Description |
 |------|-------------|
 | `analytics_query` | Master tool for raw data. Supports `dimensions`, `filters`, `aggregationType` (byPage/byProperty), `dataState` (final/all), and `type` (web/image/news/discover). |
@@ -154,9 +171,23 @@ These are low-level tools designed to be used by other AI agents to build comple
 | `pagespeed_analyze` | Lighthouse scores & Core Web Vitals. |
 | `schema_validate` | Validate Structured Data (JSON-LD). |
 
+### Bing Webmaster Tools
+| Tool | Description |
+|------|-------------|
+| `bing_sites_list` | List all verified sites in Bing. |
+| `bing_analytics_query` | Query search performance from Bing. |
+| `bing_opportunity_finder` | Find low-hanging fruit keywords on Bing. |
+| `bing_seo_recommendations` | Get prioritized SEO insights for Bing. |
+| `bing_url_info` | Detailed indexing and crawl info for a URL (Bing). |
+| `bing_index_now` | **[NEW]** Instantly notify search engines of changes. |
+| `bing_crawl_issues` | List crawl issues detected by Bing. |
+| `bing_analytics_detect_anomalies` | Detect daily spikes or drops in Bing traffic. |
+| `bing_analytics_time_series` | Advanced time series analysis for Bing. |
+| `bing_sitemaps_list` / `bing_sitemaps_submit` | Manage sitemaps in Bing. |
+
 
 
 ## License
 
-[MIT](LICENSE.md)
+[MIT](LICENSE)
 [Contributing](CONTRIBUTING.md)

package/dist/bing/client.js

@@ -0,0 +1,97 @@
+export class BingClient {
+    apiKey;
+    baseUrl = 'https://ssl.bing.com/webmaster/api.svc/json';
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async request(method, params = {}, isPost = false) {
+        const url = new URL(`${this.baseUrl}/${method}`);
+        url.searchParams.append('apikey', this.apiKey);
+        const options = {
+            method: isPost ? 'POST' : 'GET',
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        };
+        if (isPost) {
+            options.body = JSON.stringify(params);
+        }
+        else {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.append(key, String(value));
+            }
+        }
+        const response = await fetch(url.toString(), options);
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Bing API error (${method}): ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        if (data && data.hasOwnProperty('d')) {
+            return data.d;
+        }
+        return data;
+    }
+    async getSiteList() {
+        return this.request('GetUserSites');
+    }
+    async getQueryStats(siteUrl) {
+        return this.request('GetQueryStats', { siteUrl }, true);
+    }
+    async getPageStats(siteUrl) {
+        return this.request('GetPageStats', { siteUrl }, true);
+    }
+    async getPageQueryStats(siteUrl, pageUrl) {
+        return this.request('GetPageQueryStats', { siteUrl, pageUrl }, true);
+    }
+    async submitSitemap(siteUrl, sitemapUrl) {
+        await this.request('SubmitSitemap', { siteUrl, sitemapUrl }, true);
+    }
+    async getSitemaps(siteUrl) {
+        return this.request('GetSitemaps', { siteUrl }, true);
+    }
+    async getKeywordStats(q, country, language) {
+        return this.request('GetKeywordStats', { q, country, language }, true);
+    }
+    async getCrawlIssues(siteUrl) {
+        return this.request('GetCrawlIssues', { siteUrl }, true);
+    }
+    async getUrlSubmissionQuota(siteUrl) {
+        return this.request('GetUrlSubmissionQuota', { siteUrl }, true);
+    }
+    async submitUrl(siteUrl, url) {
+        return this.request('SubmitUrl', { siteUrl, url }, true);
+    }
+    async submitUrlBatch(siteUrl, urlList) {
+        return this.request('SubmitUrlBatch', { siteUrl, urlList }, true);
+    }
+    async getQueryPageStats(siteUrl) {
+        return this.request('GetQueryPageStats', { siteUrl }, true);
+    }
+    async getRankAndTrafficStats(siteUrl) {
+        return this.request('GetRankAndTrafficStats', { siteUrl }, true);
+    }
+    async getCrawlStats(siteUrl) {
+        return this.request('GetCrawlStats', { siteUrl }, true);
+    }
+    async getUrlInfo(siteUrl, url) {
+        return this.request('GetUrlInfo', { siteUrl, url }, true);
+    }
+    async getLinkCounts(siteUrl) {
+        return this.request('GetLinkCounts', { siteUrl }, true);
+    }
+    async getRelatedKeywords(q, country, language) {
+        return this.request('GetRelatedKeywords', { q, country, language }, true);
+    }
+}
+let cachedBingClient = null;
+export async function getBingClient() {
+    if (cachedBingClient)
+        return cachedBingClient;
+    const apiKey = process.env.BING_API_KEY;
+    if (!apiKey) {
+        throw new Error('Bing API Key not found. Please set BING_API_KEY environment variable or run setup.');
+    }
+    cachedBingClient = new BingClient(apiKey);
+    return cachedBingClient;
+}

package/dist/bing/docs/algorithm-updates.js

@@ -0,0 +1,31 @@
+export const algorithmUpdatesDocs = `
+# Bing Algorithm Updates & Volatility Reference
+
+The \`bing_analytics_drop_attribution\` tool correlates traffic drops with major known Bing Algorithm Updates and periods of high ranking volatility. The following updates are currently tracked:
+
+## 2025 (Projected)
+
+| Date | Update Name | Impact Area |
+|------|-------------|-------------|
+| 2025-01-15 | Projected AI Relevance Update | AI Search / Relevance |
+
+## 2024
+
+| Date | Update Name | Impact Area |
+|------|-------------|-------------|
+| 2024-07-25 | Bing Generative Search (Beta) | SERP Layout / AI Summaries |
+| 2024-05-29 | May 2024 Ranking Volatility | General Ranking |
+| 2024-03-01 | Bing Deep Search Rollout | Complex Queries / Relevance |
+
+## 2023
+
+| Date | Update Name | Impact Area |
+|------|-------------|-------------|
+| 2023-05-04 | Bing Chat Open Preview | Conversational Search |
+| 2023-02-07 | New Bing Preview (AI Chat) | AI Integration |
+| 2023-01-18 | Bing AI Integration Update | Core Ranking / AI |
+
+## How Attribution Works
+When a traffic drop is detected, the system checks if it occurred within **+/- 2 days** of any of these dates. If it matches, the update is flagged as a potential primary cause of the drop.
+`;
+export default algorithmUpdatesDocs;

package/dist/bing/docs/dimensions.js

@@ -0,0 +1,42 @@
+/**
+ * Bing Webmaster Tools - Dimensions Reference
+ *
+ * This documentation is exposed as an MCP resource for AI agents.
+ */
+export const dimensionsDocs = `# Bing Webmaster Tools - Dimensions Reference
+
+Unlike Google Search Console's single query endpoint, Bing Webmaster Tools API separates data into specific endpoints based on the primary dimension.
+
+## Implicit Dimensions via Tools
+
+| Tool | Primary Dimension | Secondary Dimensions |
+|------|-------------------|----------------------|
+| \`bing_analytics_query\` | **Query** | Date (implicit in daily options) |
+| \`bing_analytics_page\` | **Page** | Date |
+| \`bing_rank_traffic_stats\` | **Date** | None (Site level agg) |
+| \`bing_keywords_stats\` | **Keyword** | Country, Language, Date |
+
+## Usage
+
+### To Analyze Queries
+Use \`bing_analytics_query\` or \`bing_get_top_queries\`. You cannot "group by page" here.
+
+### To Analyze Pages
+Use \`bing_analytics_page\` or \`bing_get_top_pages\`.
+
+### To Analyze Date Trends
+Use \`bing_rank_traffic_stats\` or the advanced \`bing_analytics_time_series\` tool.
+
+### To Analyze Specific Page's Queries
+Use \`bing_analytics_page_query\`:
+\`\`\`json
+{
+  "siteUrl": "https://example.com",
+  "pageUrl": "https://example.com/my-page"
+}
+\`\`\`
+
+## Advanced Time Series Dimensions
+The \`bing_analytics_time_series\` tool allows analyzing trends with granular data, primarily focused on **Date** as the dimension, but data is derived from the site-level rank and traffic stats.
+`;
+export default dimensionsDocs;

package/dist/bing/docs/filters.js

@@ -0,0 +1,43 @@
+/**
+ * Bing Webmaster Tools - Filters Reference
+ *
+ * This documentation is exposed as an MCP resource for AI agents.
+ */
+export const filtersDocs = `# Bing Webmaster Tools - Filters Reference
+
+Filtering in Bing Webmaster Tools API is often done by selecting the specific tool or argument rather than a generic filter object.
+
+## Tool-Specific Filtering
+
+### Filter by Page
+To get data for a specific page, use \`bing_analytics_page_query\` instead of a generic query tool.
+\`\`\`json
+{
+  "tool": "bing_analytics_page_query",
+  "siteUrl": "https://example.com",
+  "pageUrl": "https://example.com/specific-page"
+}
+\`\`\`
+
+### Filter by Keyword/Query
+To looks up a specific keyword's history, use \`bing_keywords_stats\`:
+\`\`\`json
+{
+  "tool": "bing_keywords_stats",
+  "q": "search term",
+  "country": "us",
+  "language": "en"
+}
+\`\`\`
+
+## Advanced Analytics Filtering
+
+The \`bing_analytics_time_series\` tool supports rudimentary client-side filtering on the returned dataset.
+
+| Field | Operator | Description |
+|-------|----------|-------------|
+| \`dimension\` | \`equals\`, \`contains\` | limited support (mostly for future expansion) |
+
+_Note: The Bing API limits server-side filtering compared to Google. Most specific analysis requires fetching the relevant dataset (Queries or Pages) and processing it._
+`;
+export default filtersDocs;

package/dist/bing/docs/index.js

@@ -0,0 +1,111 @@
+/**
+ * Documentation barrel export for Bing
+ */
+export { dimensionsDocs } from './dimensions.js';
+export { filtersDocs } from './filters.js';
+export { searchTypesDocs } from './search-types.js';
+export { patternsDocs } from './patterns.js';
+export { algorithmUpdatesDocs } from './algorithm-updates.js';
+export const bingApiDocs = `
+# Bing Webmaster Tools API Documentation
+
+The Bing Webmaster Tools API allows you to manage your sites on Bing and get search performance data.
+
+## Authentication
+Authentication is handled via an **API Key**. 
+You can get your API key from the [Bing Webmaster Tools Settings](https://www.bing.com/webmasters/settings/api).
+
+## Tools
+
+### \`bing_sites_list\`
+Lists all sites verified in your Bing account.
+
+### \`bing_sites_health\`
+Runs a multi-factor health check (performance, sitemaps, crawl issues) on your Bing sites.
+
+### \`bing_analytics_query\` / \`bing_get_top_queries\`
+Returns top search queries for a site.
+
+### \`bing_analytics_page\` / \`bing_get_top_pages\`
+Returns top performing pages for a site.
+
+### \`bing_analytics_page_query\`
+Returns query performance data for a specific page.
+
+### \`bing_analytics_query_page\`
+Returns combined query and page performance stats for a site.
+
+### \`bing_rank_traffic_stats\`
+Returns historical rank and traffic statistics for a site.
+
+### \`bing_opportunity_finder\`
+Identifies "low-hanging fruit" keywords on Bing (positions 5-20 with high potential).
+
+### \`bing_seo_recommendations\`
+Provides prioritized SEO insights (cannibalization, low CTR, new ranking opportunities) for Bing.
+
+### \`bing_url_info\`
+Get detailed indexing and crawl information for a URL in Bing. Similar to Google's URL Inspection.
+
+### \`bing_link_counts\`
+Returns inbound link counts for a site.
+
+### \`bing_keywords_stats\`
+Get historical stats for a keyword in Bing.
+
+### \`bing_related_keywords\`
+Get related keywords and search volume from Bing.
+
+### \`bing_crawl_issues\`
+Lists crawl issues detected by Bing for a site.
+
+### \`bing_crawl_stats\`
+Returns crawl statistics (indexed pages, crawled pages, errors) for a site.
+
+### \`bing_url_submission_quota\`
+Get your daily URL submission quota and remaining balance.
+
+### \`bing_url_submit\`
+Submit a single URL to Bing for faster indexing.
+
+### \`bing_url_submit_batch\`
+Submit up to 500 URLs in a single request.
+
+### \`bing_sitemaps_list\`
+Lists all sitemaps submitted for a specific site.
+
+### \`bing_sitemaps_submit\`
+Submits a new sitemap URL to Bing.
+
+### \`bing_analytics_detect_anomalies\`
+Detects sharp traffic drops or spikes in Bing performance data.
+
+### \`bing_analytics_compare_periods\`
+Compares Bing performance metrics between two date ranges (clicks, impressions, position).
+
+### \`bing_analytics_drop_attribution\`
+Analyzes traffic drops to attribute them to potential causes (device-specific issues, etc.).
+
+### \`bing_analytics_time_series\`
+Performs advanced time series analysis with smoothing and trend forecasting for Bing data.
+
+`;
+export const indexNowDocs = `
+# IndexNow Documentation
+
+IndexNow is a simple way for website owners to instantly inform search engines about recent content changes on their website.
+
+## How it works
+1. **Generate a Key**: Create a unique key (UUID) for your host.
+2. **Host the Key**: Serve the key as a text file at the root of your host or a specific location.
+3. **Submit URLs**: Use the \`bing_index_now\` tool to notify search engines of new, updated, or deleted URLs.
+
+## Tool: \`bing_index_now\`
+Arguments:
+- \`host\`: The domain (e.g., \`www.example.com\`).
+- \`key\`: Your generated IndexNow key.
+- \`keyLocation\` (optional): The URL where the key is hosted if not at the root.
+- \`urlList\`: An array of URLs that have changed.
+
+For more information, visit [IndexNow.org](https://www.indexnow.org/).
+`;

package/dist/bing/docs/patterns.js

@@ -0,0 +1,108 @@
+/**
+ * Bing Webmaster Tools - Common Patterns & Recipes
+ *
+ * This documentation is exposed as an MCP resource for AI agents.
+ */
+export const patternsDocs = `# Bing Webmaster Tools - Common Patterns & Recipes
+
+This guide shows common use cases and patterns for analyzing Bing Webmaster Tools data.
+
+## Quick Reference
+
+### Get Site Performance Overview
+Use \`bing_rank_traffic_stats\` for high-level metrics (Clicks, Impressions, Position) over time:
+\`\`\`
+Tool: bing_rank_traffic_stats
+Args: { "siteUrl": "https://example.com" }
+\`\`\`
+
+### Submit Content (IndexNow)
+Instantly notify Bing of new content using IndexNow (preferred over sitemaps for speed):
+\`\`\`
+Tool: bing_index_now
+Args: { 
+  "host": "www.example.com",
+  "key": "YOUR_KEY",
+  "urlList": ["https://www.example.com/new-page"]
+}
+\`\`\`
+
+---
+
+## Content Analysis
+
+### Top Performing Queries
+\`\`\`json
+{
+  "tool": "bing_analytics_query",
+  "siteUrl": "https://example.com"
+}
+\`\`\`
+
+### Top Performing Pages
+\`\`\`json
+{
+  "tool": "bing_analytics_page",
+  "siteUrl": "https://example.com"
+}
+\`\`\`
+
+### Deep Dive: Queries for a Specific Page
+Find out what a specific page ranks for:
+\`\`\`json
+{
+  "tool": "bing_analytics_page_query",
+  "siteUrl": "https://example.com",
+  "pageUrl": "https://example.com/blog/my-post"
+}
+\`\`\`
+
+---
+
+## Diagnostics & Health
+
+### Traffic Drop Analysis
+If you see a sudden drop in traffic, use attribution to check for algorithm updates:
+\`\`\`json
+{
+  "tool": "bing_analytics_drop_attribution",
+  "siteUrl": "https://example.com",
+  "days": 30
+}
+\`\`\`
+
+### Check URL Indexing Status
+Verify if a URL is indexed and see crawl issues:
+\`\`\`json
+{
+  "tool": "bing_url_info",
+  "siteUrl": "https://example.com",
+  "url": "https://example.com/troublesome-page"
+}
+\`\`\`
+
+### List Crawl Issues
+\`\`\`json
+{
+  "tool": "bing_crawl_issues",
+  "siteUrl": "https://example.com"
+}
+\`\`\`
+
+---
+
+## Advanced Time Series
+
+### Forecasting Traffic
+Predict future clicks based on historical trends:
+\`\`\`json
+{
+  "tool": "bing_analytics_time_series",
+  "siteUrl": "https://example.com",
+  "days": 90,
+  "forecastDays": 30,
+  "granularity": "weekly"
+}
+\`\`\`
+`;
+export default patternsDocs;

package/dist/bing/docs/search-types.js

@@ -0,0 +1,21 @@
+/**
+ * Bing Webmaster Tools - Search Types Reference
+ *
+ * This documentation is exposed as an MCP resource for AI agents.
+ */
+export const searchTypesDocs = `# Bing Webmaster Tools - Search Types Reference
+
+Bing Webmaster Tools API primarily provides data for **Web** search.
+
+## Unified Data
+Unlike Google Search Console which explicitly separates "Web", "Image", "Video", and "News" into distinct search types for every query, Bing's standard performance APIs (\`GetQueryStats\`, \`GetPageStats\`) return unified performance data.
+
+## Keyword Research Types
+When using \`bing_keywords_stats\`, you can filter by:
+- **Country**: (e.g., 'us', 'gb', 'in')
+- **Language**: (e.g., 'en-US', 'en-GB')
+
+## Future Support
+If Bing APIs expose explicit filtering for Image/Video verticals in the future, this documentation will be updated to reflect those capabilities.
+`;
+export default searchTypesDocs;