CrawlForge
搜索Google API5 credits

search_web

由 Google Custom Search API 驱动的程序化网页搜索，具备高级筛选、排序和结果元数据。非常适合自动化研究和内容发现。

使用场景

研究自动化

通过搜索学术论文、新闻文章或技术文档实现研究自动化

内容发现

为内容创作和策展寻找相关内容、博客或资源

竞争监控

在全网范围内追踪对您的品牌、产品或竞争对手的提及

潜在客户挖掘

根据搜索条件寻找潜在客户、合作伙伴或商机

SEO 研究

分析搜索结果，以了解排名因素和竞争对手策略

数据收集

根据搜索查询收集 URL 以供进一步抓取或分析

Endpoint

POST/api/v1/tools/search_web
Auth Required
2 req/s on Free plan
5 credits

Parameters

NameTypeRequiredDefaultDescription
query
stringRequired-
搜索查询（支持高级运算符）
Example: best web scraping tools 2025
limit
numberOptional10
要返回的结果数量（1-100）
Example: 25
timeRange
stringOptional-
按发布日期筛选：day、week、month、year 或 custom
Example: month
safeSearch
booleanOptionaltrue
过滤露骨内容
Example: true
site
stringOptional-
将搜索限定在特定站点或域名
Example: github.com
fileType
stringOptional-
按文件类型筛选：pdf、doc、xls、ppt 等
Example: pdf
language
stringOptionalen
语言代码（ISO 639-1）
Example: en
country
stringOptional-
用于获取特定地区结果的国家/地区代码（ISO 3166-1）
Example: us

请求示例

terminalBash

响应示例

200 OK1,250ms
{
  "success": true,
  "data": {
    "query": "best web scraping tools 2025",
    "totalResults": 12500000,
    "resultsReturned": 25,
    "results": [
      {
        "position": 1,
        "title": "Top 10 Web Scraping Tools for 2025 - Developer Guide",
        "url": "https://example.com/scraping-tools",
        "displayUrl": "example.com › scraping-tools",
        "snippet": "Discover the best web scraping tools in 2025 including CrawlForge MCP, Beautiful Soup, and Scrapy. Compare features, pricing, and use cases...",
        "date": "2025-09-15",
        "domain": "example.com",
        "favicon": "https://example.com/favicon.ico"
      },
      {
        "position": 2,
        "title": "CrawlForge MCP: The Ultimate Web Scraping Solution",
        "url": "https://crawlforge.dev",
        "displayUrl": "crawlforge.dev",
        "snippet": "CrawlForge MCP offers 23 powerful web scraping tools in one API. Start with 1,000 free credits and automate your data extraction...",
        "date": "2025-09-28",
        "domain": "crawlforge.dev",
        "favicon": "https://crawlforge.dev/favicon.ico"
      }
    ],
    "searchMetadata": {
      "searchTime": 0.45,
      "language": "en",
      "country": "us",
      "safeSearch": true,
      "timeRange": "month"
    }
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1250
}
Field Descriptions
data.totalResults可用结果总数（并非全部返回）
data.resultsReturned本次响应中的结果数量
data.results包含元数据的搜索结果数组
data.results[].snippet来自页面的描述摘录
data.results[].date发布日期（如果可用）
credits_used每次搜索查询固定消耗 5 credits
processing_time搜索通常在 1-2 秒内完成

错误处理

查询为空（400 Bad Request）

搜索查询不能为空。请提供至少 2 个字符。

未找到结果（404 Not Found）

没有搜索结果匹配您的查询。请尝试更宽泛的搜索词或移除筛选条件。

参数无效（400 Bad Request）

请检查 timeRange、language 或 country 参数是否为有效值。

配额超限（429 Too Many Requests）

搜索 API 有每日限额。升级您的套餐 以获得更高配额。

专业提示： 在查询中使用 site:、filetype: 或 intitle: 等搜索运算符可获得更精确的结果。示例："site:github.com web scraping" 仅返回 GitHub 的结果。

Credit 费用

5 credits
每次搜索 5 credits
固定费用，与结果数量无关。仅对成功的搜索扣除 credits。

包含内容：

每次搜索最多 100 条结果

高级筛选（时间、站点、文件类型）

多语言和多国家/地区支持

安全搜索过滤

结果元数据（日期、域名、摘要）

套餐推荐：

Free 套餐： 1,000 个一次性试用 credits = 200 次搜索

Hobby 套餐： 5,000 credits = 1,000 次搜索（$19/mo）

Professional 套餐： 50,000 credits = 10,000 次搜索（$99/mo）

相关工具

deep_research
具备 AI 分析的多阶段研究（10 credits）
batch_scrape
并行抓取搜索结果 URL（每个 URL 1 credit）
analyze_content
分析搜索结果的情感和主题（3 credits）
extract_content
从搜索结果中提取主要内容（2 credits）
准备好试用 search_web 了吗？免费注册，获取 1,000 credits，开始构建。