项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 32651
使用教程
环境要求
- Python 环境(README 未指定版本,建议 3.9+)
- pip 包管理工具
- 使用本地模型需先安装 Ollama 并 pull 模型
- 使用 OpenAI 等云端模型需准备 API Key
安装与启动步骤
-
1安装依赖库
用 pip 安装 scrapegraphai 包,README 明确给出的唯一安装命令。
pip install scrapegraphai -
2安装本地模型
若用 Ollama 本地模型,需先安装 Ollama 并拉取 llama3.2 模型。
ollama pull llama3.2 -
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切换云端模型
改用 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-mini | ollama/llama3.2 |
llm.api_key | 否 | 云端模型所需的 API 密钥,使用 Ollama 本地模型时无需填写 | sk-xxxxxxxx |
llm.model_tokens | 否 | 模型可用的 token 上限,README 示例中为 8192 | 8192 |
llm.format | 否 | 输出格式设置,README 示例中设为 json | json |
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
上一篇:firecrawl
同类项目推荐
documentation-helper
开源
用 RAG 快速搭建文档问答助手,让文档秒变智能客服
Reference implementation of a RAG-based documentation helper using LangChain, Pineco···
awesome-selfhosted-ai
开源
每周体检的自托管 AI 项目清单,直接照着搭
Curated list of self-hosted open-source AI: local LLMs, chat UIs, agents, MCP server···
Advanced_RAG
开源
用Notebook快速上手高级RAG,融合GPT与Llama3
Advanced Retrieval-Augmented Generation (RAG) through practical notebooks, using the···
duckdb-embedding-search
开源
用DuckDB跑向量搜索,免装向量数据库,小数据量秒级响应
Fast similarity search using DuckDB
chatbot
开源
用 MongoDB 向量搜索,快速搭建私有知识问答机器人
MongoDB Knowledge Service. Powered by MongoDB and Atlas Vector Search.
Awesome-LLM4Cybersecurity
开源
一张清单看懂 LLM 如何用于攻防安全
An overview of LLMs for cybersecurity.
RAG_Techniques
开源
一站式学透 RAG 进阶技巧,从入门到实战快速上手
This repository showcases various advanced techniques for Retrieval-Augmented Genera···
KG_RAG
开源
用知识图谱给大模型装上结构化记忆,回答更准更可解释
Empower Large Language Models (LLM) using Knowledge Graph based Retrieval-Augmented ···
meilisearch
开源
几分钟接入毫秒级搜索,还带 AI 混合检索
A lightning-fast search engine API bringing AI-powered hybrid search to your sites a···
