Search

You are wiring up the superagnt "X (Twitter)" API to use this endpoint: Search.

1. CONNECT over MCP (preferred). No token to paste either way.
   On Claude (claude.ai, the desktop app, or Claude Code signed in with a Claude
   account), the server is a connector: give the user this link, they click Add
   and approve:
     https://claude.ai/customize/connectors/yours?modal=add-custom-connector&connectorName=superagnt&connectorUrl=https%3A%2F%2Fmcp.superagnt.com%2Fmcp&open_in_browser=1
   Any other MCP client (or Claude Code signed in with an API key): add the server
   and let the client run the browser sign-in:
     claude mcp add --scope user --transport http superagnt https://mcp.superagnt.com/mcp
     claude mcp login superagnt
   MCP endpoint: https://mcp.superagnt.com/mcp
   After connecting, the tool you want is named exactly:
     data_x_search_get_search_search
   Call agnt_tools_search or agnt_tools_list_enabled to confirm it is available.

2. REST fallback (if you are not using MCP):
     GET https://api.superagnt.com/search/search
     Header: Authorization: Bearer <YOUR_AGNTDATA_API_KEY>
   Required parameters:
    - query (string, required)
   Optional parameters:
    - limit (number, optional)
    - language (string, optional)
    - start_date (string, optional) — YYYY-MM-DD
    - min_likes (number, optional)
    - min_retweets (number, optional)
    - end_date (string, optional)
    - min_replies (number, optional)
    - section (string, optional)

3. COST & KEY. Each successful call costs $0.005 in credits. Only successful calls are charged.
   Get a superagnt API key at https://app.superagnt.com.

4. TEST. Connect the server (or set the key), discover the tool
   (data_x_search_get_search_search), run one minimal call with just the required parameters,
   and report back the shape of the JSON response (top-level fields).

Reference (machine-readable variant): https://www.superagnt.com/docs/apis/social/x/endpoints/Search_get__search_search.md

{
  "name": "search_get_search_search",
  "description": "This endpoint return search results",
  "parameters": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "number",
        "description": "query parameter",
        "default": "5",
        "maximum": 50
      },
      "language": {
        "type": "string",
        "description": "query parameter",
        "default": "en"
      },
      "start_date": {
        "type": "string",
        "description": "YYYY-MM-DD",
        "default": "2022-01-01"
      },
      "min_likes": {
        "type": "number",
        "description": "query parameter",
        "default": "1"
      },
      "min_retweets": {
        "type": "number",
        "description": "query parameter",
        "default": "1"
      },
      "query": {
        "type": "string",
        "description": "query parameter",
        "default": "#python"
      },
      "end_date": {
        "type": "string",
        "description": "query parameter"
      },
      "min_replies": {
        "type": "number",
        "description": "query parameter"
      },
      "section": {
        "type": "string",
        "description": "query parameter",
        "default": "top",
        "enum": [
          "top",
          "latest",
          "people",
          "photos",
          "videos"
        ]
      }
    },
    "required": [
      "query"
    ]
  }
}