Scrapegraph-ai

说人话就能爬网页,数据自己送到你面前

基于 AI 的 Python 爬虫库,用自然语言描述需求即可智能解析网页、提取结构化数据,大幅降低传统爬虫的编写与维护成本。

开源 freemium 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 31202
维护状态 较活跃
是否开源 是
定价模式 freemium

项目数据

分类搜索知识
开发团队ScrapeGraphAI
所属国家
定价模式freemium
价格说明提供免费额度,付费计划解锁更多功能,具体价格见官网。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai-crawler,ai-scraping,ai-search,crawler,data-extraction,firecrawl-alternative,large-language-model,llm,markdown,rag,scraping,scraping-python,web-crawler,web-crawlers,web-data,web-data-extraction,web-scraper,web-scraping,web-search,webscraping
GitHub 星标★ 31202
30天Star增速
HF 下载量
上线时间2024-01-27 00:00:00
最近更新2026-09-22 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:入门 约 15 分钟 部署方式:库/依赖 4 步

环境要求

  • Python 环境(README 未指定版本,建议 3.9+)
  • pip 包管理工具
  • 使用本地模型需先安装 Ollama 并 pull 模型
  • 使用 OpenAI 等云端模型需准备 API Key

安装与启动步骤

  1. 1安装依赖库

    用 pip 安装 scrapegraphai 包,README 明确给出的唯一安装命令。

    pip install scrapegraphai
  2. 2安装本地模型

    若用 Ollama 本地模型,需先安装 Ollama 并拉取 llama3.2 模型。

    ollama pull llama3.2
  3. 3编写爬虫脚本

    导入 SmartScraperGraph,配置 llm 与目标 URL,按提示词提取信息。

    from scrapegraphai.graphs import SmartScraperGraph
    
    graph_config = {
        "llm": {
            "model": "ollama/llama3.2",
            "model_tokens": 8192,
            "format": "json",
        },
        "verbose": True,
        "headless": False,
    }
    
    smart_scraper_graph = SmartScraperGraph(
        prompt="List me all the projects with their description",
        source="https://scrapegraphai.com/",
        config=graph_config,
    )
    
    result = smart_scraper_graph.run()
    
    import json
    print(json.dumps(result, indent=4))
  4. 4切换云端模型

    改用 OpenAI 等模型时只需替换 llm 配置,填入自己的 api_key 与模型名。

    graph_config = {
        "llm": {
            "api_key": "sk-xxxxxxxx",
            "model": "openai/gpt-4o-mini",
        },
        "verbose": True,
        "headless": False,
    }

关键配置

配置项必填说明示例
llm.model是指定使用的 LLM,如 ollama/llama3.2 或 openai/gpt-4o-miniollama/llama3.2
llm.api_key否云端模型所需的 API 密钥,使用 Ollama 本地模型时无需填写sk-xxxxxxxx
llm.model_tokens否模型可用的 token 上限,README 示例中为 81928192
llm.format否输出格式设置,README 示例中设为 jsonjson
verbose否是否打印详细运行日志True
headless否是否以无头模式运行浏览器False

如何确认成功

运行脚本后能打印出结构化的 JSON 字典结果(如 description、founders 等字段),即表示成功。

常见问题

Q:必须用 OpenAI 吗?

A:不必。README 说明可通过 API 使用 OpenAI、Groq、Azure、Gemini、MiniMax 等,也可用 Ollama 跑本地模型。

Q:想用本地模型怎么办?

A:先安装 Ollama,并用 ollama pull 下载模型(如 llama3.2),再把 llm.model 改成 ollama/llama3.2。

Q:还有哪些爬取流程可用?

A:除 SmartScraperGraph 外,还有 SearchGraph、SpeechGraph、ScriptCreatorGraph、SmartScraperMultiGraph 等,均有并行多版本。

Q:如何换用云端模型?

A:只需修改 llm 配置:填入 api_key 并把 model 换成如 openai/gpt-4o-mini 即可。

注意事项

  • README 未给出 Python 版本要求,建议使用较新的 Python 3.9+。
  • API Key 属于敏感信息,不要硬编码后上传到公开仓库。
  • 云端模型会产生调用费用,本地 Ollama 模型则依赖本机算力。

核心亮点

  • 基于LLM的智能爬虫,能理解自然语言指令并自动提取结构化数据,显著降低传统爬虫的规则维护成本
  • 支持RAG和Markdown输出,可直接对接下游数据处理流程,适合构建知识库或数据分析管道
  • 提供Firecrawl替代方案,开源免费,且拥有活跃的社区和丰富的文档示例

不足之处

  • 依赖外部LLM API,运行成本和延迟较高,且对网络环境有要求
  • 复杂页面或动态内容处理能力有限,可能需结合其他工具或自定义逻辑

适用场景

  • 从多个网站自动提取产品价格、评论等信息,用于市场调研或竞品分析
  • 将网页内容转换为结构化Markdown,供RAG系统或大模型训练使用
  • 快速构建垂直领域知识图谱或数据管道,无需编写繁琐的爬虫规则

替代项目

Firecrawl、Crawl4AI、Scrapy

项目介绍

Scrapegraph-ai 是搜索知识领域的开源项目,由 ScrapeGraphAI 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(31,202)位列前 2%,在搜索知识分类的 581 个项目里位列前 4%。

近 44 天,它的 GitHub 星标从 29,273 增加到 31,202,净增 1,929。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-22。提供免费额度,付费计划解锁更多功能,具体价格见官网。从国内网络环境看,可直接访问。

它主要面向的使用场景是:从多个网站自动提取产品价格、评论等信息,用于市场调研或竞品分析。同类可对比的替代方案包括 Firecrawl、Crawl4AI、Scrapy。

上一篇:firecrawl

下一篇:google-ai-mode-scraper

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

The web data API to search, scrape, and interact at scale.

★ 183325 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

整个代码库画成一张图,找问题一眼定位

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 120493 2026-08-09
ragflow 开源

让大模型用上你的私有知识,搭建可靠的企业级RAG应用

RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fu···

★ 91170 2026-08-09