get_children_url_info
Retrieve information about child URLs for a specific parent URL in Bing Webmaster Tools. Use this tool to analyze website structure, identify linked pages, and monitor subpage details with filtering options.
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 |
Implementation Reference
- mcp_server_bwt/tools/bing_webmaster.py:188-189 (registration)Registers the 'get_children_url_info' tool using wrap_service_method, which decorates it as an MCP tool (@mcp.tool()) and delegates execution to the underlying ContentManagementService.get_children_url_info method.get_children_url_info = wrap_service_method( # noqa: F841 mcp, service, "content", "get_children_url_info"
- The dynamically generated handler function (wrapper) that executes the tool logic: binds to the service instance, calls the underlying service method 'get_children_url_info', and preserves the original signature and docstring.# 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__
- Helper function that creates the MCP tool handler by inspecting the service method signature, decorating with @mcp.tool(), and proxying calls to the BingWebmasterService's content management service.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
- Initializes and exposes the 'content' service attribute on BingWebmasterService, providing the ContentManagementService instance that contains the 'get_children_url_info' method.self.content = content_management.ContentManagementService(self.client)
- mcp_server_bwt/main.py:17-17 (registration)Invokes the function that registers all Bing Webmaster tools, including 'get_children_url_info', to the MCP server.add_bing_webmaster_tools(mcp, bing_service)