ScrapeMole Search

Use when an agent needs to search the web: research, fact finding, finding official pages/docs, competitor or link discovery, grounding an answer with URLs. Returns ranked organic results (position, title, url, domain, snippet; published date or lastCrawled time when the source has one). The top 10 come from Bing's public RSS results; deeper pages (count > 10 or page > 1) come from Brave Search. Supports operators the engines support in q (site:, "exact phrase", -exclude, filetype:). If the primary source is unavailable or off-topic it falls back to Brave Search, then the Mwmbl open index; the response says which source answered (source, sourceUrl, fallbackFrom). Pair with ScrapeMole Reader /v1/read to turn a result URL into Markdown. Empty results = 404, not charged. Paid tool: x402 USDC on Base, $0.001 per successful call; call without payment to receive the PaymentRequired object.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query (max 400 chars). Operators like site:example.com, \"exact phrase\", -word work."
    },
    "count": {
      "type": "string",
      "description": "Number of results (1-20).",
      "default": "10"
    },
    "page": {
      "type": "string",
      "description": "Result page (1-5); each page is \"count\" results.",
      "default": "1"
    },
    "market": {
      "type": "string",
      "description": "Market/locale as language-COUNTRY, e.g. en-US, en-GB, de-DE, fr-FR, ja-JP (applied on the Bing source).",
      "default": "en-US"
    },
    "safe": {
      "type": "string",
      "description": "Safe search level.",
      "enum": [
        "strict",
        "moderate",
        "off"
      ],
      "default": "moderate"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Use for current events, monitoring a company/person/topic in the press, finding recent coverage before answering, or building news digests. Returns up to 20 articles with title, direct article url (no redirect wrapper), publisher, published time (ISO 8601), snippet and image when available. sort=date for newest first; freshness=hour|day|week|month to limit age; market for regional editions (en-US, en-GB, de-DE, …). Primary source is Bing News public RSS (retried automatically when Bing answers an empty page), fallback Brave Search News; the response names the source used. Empty results = 404, not charged. Paid tool: x402 USDC on Base, $0.002 per successful call; call without payment to receive the PaymentRequired object.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "News query (max 400 chars), e.g. a company, person, topic; site:reuters.com works on Bing."
    },
    "count": {
      "type": "string",
      "description": "Number of results (1-20).",
      "default": "10"
    },
    "page": {
      "type": "string",
      "description": "Result page (1-5); each page is \"count\" results.",
      "default": "1"
    },
    "market": {
      "type": "string",
      "description": "Market/locale as language-COUNTRY, e.g. en-US, en-GB, de-DE, fr-FR, ja-JP (applied on the Bing source).",
      "default": "en-US"
    },
    "sort": {
      "type": "string",
      "description": "relevance (default) or date (newest first).",
      "enum": [
        "relevance",
        "date"
      ],
      "default": "relevance"
    },
    "freshness": {
      "type": "string",
      "description": "Maximum article age.",
      "enum": [
        "any",
        "hour",
        "day",
        "week",
        "month"
      ],
      "default": "any"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Use for keyword research, SEO/content ideas, query expansion before /v1/web or /v1/news, or guessing what people search for around a topic ("how to la" -> "how to lay tile", …). Returns the completions in source order. lang sets the suggestion language (en, de, fr, es, ja, …). Primary source Google's public suggest endpoint, fallback DuckDuckGo autocomplete; the response names the source used. No suggestions = 404, not charged. Paid tool: x402 USDC on Base, $0.001 per successful call; call without payment to receive the PaymentRequired object.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Partial query (max 200 chars)."
    },
    "lang": {
      "type": "string",
      "description": "Two-letter language code.",
      "default": "en"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}