get_crawl_stats
Get daily crawl statistics for any site by submitting its URL. Monitor Bingbot activity and crawl performance across a custom date range.
Instructions
Retrieve crawl statistics for a specific site within a date range.
Args: site_url: The URL of the site
Returns: List[CrawlStats]: List of daily crawl statistics
Raises: BingWebmasterError: If statistics cannot be retrieved
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| self | Yes | ||
| site_url | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- mcp_server_bwt/tools/bing_webmaster.py:36-80 (registration)The `wrap_service_method` helper that dynamically registers service methods as MCP tools. When called for 'get_crawl_stats', it wraps the `get_crawl_stats` method from the `crawling.CrawlingService` class.
def wrap_service_method( mcp: FastMCP, service: BingWebmasterService, service_attr: str, method_name: str ) -> Callable[..., Any]: """Helper function to wrap a service method with mcp.tool() while preserving its signature and docstring. Args: mcp: The MCP server instance service: The BingWebmasterService instance service_attr: The service attribute name (e.g., 'sites', 'submission') method_name: The method name to wrap Returns: The wrapped method as an MCP tool """ # Get the service class from our mapping service_class = SERVICE_CLASSES[service_attr] # Get the original method original_method = getattr(service_class, method_name) # Get the signature sig = inspect.signature(original_method) # Remove 'self' parameter from signature parameters = list(sig.parameters.values())[1:] # Skip 'self' # Create new signature without 'self' new_sig = sig.replace(parameters=parameters) # Create wrapper function with same signature @mcp.tool() @wraps(original_method) async def wrapper(*args: Any, **kwargs: Any) -> Any: # Filter out any 'self' arguments that might be passed by the MCP client kwargs = {k: v for k, v in kwargs.items() if k != "self"} async with service as s: service_obj = getattr(s, service_attr) # Get the method from the instance method = getattr(service_obj, method_name) # Call the method directly - it's already bound to the instance return await method(*args, **kwargs) # Copy signature and docstring wrapper.__signature__ = new_sig # type: ignore wrapper.__doc__ = original_method.__doc__ return wrapper - mcp_server_bwt/tools/bing_webmaster.py:141-141 (registration)Registration of the 'get_crawl_stats' tool. It calls wrap_service_method(mcp, service, 'crawling', 'get_crawl_stats') to wrap the crawling service's get_crawl_stats method as an MCP tool.
get_crawl_stats = wrap_service_method(mcp, service, "crawling", "get_crawl_stats") # noqa: F841 - mcp_server_bwt/services/bing_webmaster.py:48-49 (registration)The `BingWebmasterService` instantiates `crawling.CrawlingService(self.client)` as `self.crawling`, which is the service object whose `get_crawl_stats` method is ultimately called.
self.crawling = crawling.CrawlingService(self.client) self.keywords = keyword_analysis.KeywordAnalysisService(self.client) - Mapping of 'crawling' service attribute name to `crawling.CrawlingService` class (from the external bing_webmaster_tools package), used by wrap_service_method.
"crawling": crawling.CrawlingService, "keywords": keyword_analysis.KeywordAnalysisService, - mcp_server_bwt/main.py:17-26 (registration)Entry point where `add_bing_webmaster_tools` is called, which registers all tools including get_crawl_stats.
add_bing_webmaster_tools(mcp, bing_service) def app() -> None: """Command-line interface entry point.""" mcp.run(transport="stdio") if __name__ == "__main__": app()