add_deep_link_block
Block specific deep links from appearing in Bing search results for a website by specifying the site URL, market, and target URLs.
Instructions
Add a deep link block.
Args: site_url: The URL of the site market: The market code search_url: The search URL deep_link_url: The deep link URL to block
Raises: BingWebmasterError: If block cannot be added
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| self | Yes | ||
| site_url | Yes | ||
| market | Yes | ||
| search_url | Yes | ||
| deep_link_url | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- mcp_server_bwt/tools/bing_webmaster.py:166-168 (registration)Registers the 'add_deep_link_block' MCP tool by wrapping the 'add_deep_link_block' method from the 'links' service (link_analysis.LinkAnalysisService). The wrapper is decorated with @mcp.tool() and preserves the original method's signature and docstring.
add_deep_link_block = wrap_service_method( # noqa: F841 mcp, service, "links", "add_deep_link_block" ) - The core handler logic executed by the tool. It acquires the BingWebmasterService context, retrieves the 'links' sub-service instance, binds the 'add_deep_link_block' method, and invokes it with the provided arguments. This is the dynamically generated function for the tool.
@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__ - Helper function that generates the MCP tool handler for service methods, including signature preservation and docstring copying from the original service method.
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 - In the __aenter__ of BingWebmasterService, initializes and exposes the 'links' sub-service instance (link_analysis.LinkAnalysisService) which provides the 'add_deep_link_block' method delegated to by the tool handler.
# Expose all services directly self.sites = site_management.SiteManagementService(self.client) self.submission = submission.SubmissionService(self.client) self.traffic = traffic_analysis.TrafficAnalysisService(self.client) self.crawling = crawling.CrawlingService(self.client) self.keywords = keyword_analysis.KeywordAnalysisService(self.client) self.links = link_analysis.LinkAnalysisService(self.client) self.content = content_management.ContentManagementService(self.client) self.blocking = content_blocking.ContentBlockingService(self.client) self.regional = regional_settings.RegionalSettingsService(self.client) self.urls = url_management.UrlManagementService(self.client) return self - mcp_server_bwt/main.py:17-17 (registration)Invokes the function that registers all Bing Webmaster tools, including 'add_deep_link_block', to the MCP server.
add_bing_webmaster_tools(mcp, bing_service)