ArmaVita Meta Ads MCP

Instructions

Implementation Reference

• src/armavita_meta_ads_mcp/core/research_tools.py:420-450 (handler)

  The `search_web_content` function is registered as an MCP tool and executes the web content search logic using `_data_manager.search_records`.

  @mcp_server.tool()
  @meta_api_tool
  async def search_web_content(
      query: str,
      meta_access_token: Optional[str] = None,
  ) -> str:
      """Search through Meta Ads data and return matching record IDs."""
      if not query:
          return json.dumps({"error": "query parameter is required", "ids": []}, indent=2)
  
      try:
          matching_ids = await _data_manager.search_records(query, meta_access_token)
          return json.dumps(
              {
                  "ids": matching_ids,
                  "query": query,
                  "total_results": len(matching_ids),
              },
              indent=2,
          )
      except Exception as e:
          logger.error(f"Error in search_web_content tool: {e}")
          return json.dumps(
              {
                  "error": "Failed to search_web_content Meta Ads data",
                  "details": str(e),
                  "ids": [],
                  "query": query,
              },
              indent=2,
          )