get_children_url_info
Retrieve child URL information for a parent URL to inspect site structure, crawl status, and filter by properties such as HTTP code or crawl date.
Instructions
Retrieve information for child URLs of a specific URL.
Args: site_url: The URL of the site url: The parent URL to get child URL information for page: The page number of results to retrieve filter_properties: Properties to filter the results
Returns: List[UrlInfo]: List of URL information for child URLs
Raises: BingWebmasterError: If child URL information cannot be retrieved
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| self | Yes | ||
| site_url | Yes | ||
| url | Yes | ||
| page | No | ||
| filter_properties | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- The `wrap_service_method` function is the generic handler factory that dynamically creates the tool handler. When called with args (mcp, service, 'content', 'get_children_url_info'), it wraps the `ContentManagementService.get_children_url_info` method as an MCP tool by generating a decorated async wrapper that calls the underlying 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 - mcp_server_bwt/tools/bing_webmaster.py:188-190 (registration)Registration of the 'get_children_url_info' tool. This is where the tool is registered by calling wrap_service_method with 'content' service and 'get_children_url_info' method, and then decorating with @mcp.tool() inside wrap_service_method.
get_children_url_info = wrap_service_method( # noqa: F841 mcp, service, "content", "get_children_url_info" ) - Schema mapping that maps 'content' to ContentManagementService. The actual parameter schema is derived from the signature of ContentManagementService.get_children_url_info (from the external bing_webmaster_tools package), which is inspected by wrap_service_method.
SERVICE_CLASSES = { "sites": site_management.SiteManagementService, "submission": submission.SubmissionService, "traffic": traffic_analysis.TrafficAnalysisService, "crawling": crawling.CrawlingService, "keywords": keyword_analysis.KeywordAnalysisService, "links": link_analysis.LinkAnalysisService, "content": content_management.ContentManagementService, "blocking": content_blocking.ContentBlockingService, "regional": regional_settings.RegionalSettingsService, "urls": url_management.UrlManagementService, } - mcp_server_bwt/main.py:14-17 (helper)Top-level entry point that creates the BingWebmasterService and calls add_bing_webmaster_tools, which registers get_children_url_info as an MCP tool.
bing_service = BingWebmasterService(api_key=api_key) # Add the tools to the MCP server add_bing_webmaster_tools(mcp, bing_service)