MCPcopy
hub / github.com/SpiderClub/weibospider

github.com/SpiderClub/weibospider @v1.7.2 sqlite

repository ↗ · DeepWiki ↗ · release v1.7.2 ↗
231 symbols 906 edges 58 files 63 documented · 27%
README

关于本项目 :octocat:

- 实现内容包括用户信息、用户主页所有微博、微博搜索、微博评论和微博转发关系抓取等 - 本项目基于本人实际的工作,并对此做了大量的修改,可以保证项目的稳定运行

为何选择本项目 :star:

  • 功能全面:包括了用户信息抓取、指定关键字搜索结果增量抓取、指定用户主页所有微博抓取、评论抓取和转发关系抓取等
  • 数据全面:PC端展现的数据量比移动端更加丰富。并且相比于其它同类项目对微博的简单分析,本项目做了大量细致的工作, 比如不同domain不同用户的解析策略、不同domain不同用户的主页分析策略等
  • 稳定!项目可以长期稳定运行。
  • 为了保证程序能长期稳定运行,数据所有的网络请求都是通过抓包手动分析的,未用任何自动化工具,包括模拟登陆! 从另一个方面来说,抓取速度也是比较有保证的
  • 通过合理的阈值设定,账号可以保证安全。但是不推荐用户使用自己的常用账号
  • 即使账号不可用或者登陆失败,项目都对其做了处理(智能冻结账号,出错重试等),以保证每次请求都是有效的,并及时把错误反馈给用户
  • 通过大量的异常检测和处理,几乎捕获了所有的解析和抓取异常。编写了大量的解析代码来获取足够全面的信息
  • 复用性和二次开发性很好。项目很多地方都有详细的代码注释,方便阅读。即使本项目不能完全满足你 对微博数据采集和分析的需求,你也可以自己在该项目的基础上做二次开发,项目已经在微博抓取和各个 模版解析上做了大量工作。
  • 由于本项目与本人实际工作有关联(代码并不是工作中使用的代码),所以可以放心它会长期更新。目前已经迭代一年有余了。
  • 丰富文档支持:请点击wiki查看所有文档。如果文档仍然不能解 决你的问题,欢迎提issue,维护者看到后都会积极回答,也可以通过加QQ群(群号:499500161, 暗号:微博爬虫,务必备注加群信息,否则 视为广告处理)进行交流。

配置和使用 :sparkles:

使用前请大家务必仔细读项目配置 和 项目使用

配置

建议新手和小白们先查看演示视频(链接: https://pan.baidu.com/s/1eSy2qzw 密码: ypn5)

  • 环境配置:如果环境配置经验比较少,建议直接点击查看项目环境配置
  • 考虑到Python3是趋势和一些将该项目用于学习的用户,项目运行环境为Python3.x
  • 项目存储后端使用Mysql,所以需要在存储服务器上安装Mysql,注意设置字符集编码为utf-8
  • 由于项目是使用celery做分布式任务调度,所以 需要使用broker和各个分布式节点通信,项目使用的是Redis,所以需要先安装Redis。 注意修改Redis的配置文件让它能监听除本机外的别的节点的请求,建议给Redis设置密码,如 果没设置密码,需要关闭保护模式(不推荐,这个有安全风险)才能和各个节点通信。如果害怕遇到Redis单点 故障,可以使用Redis主从配置。

  • 项目相关配置

  • 对Python虚拟环境了解的朋友可以使用 source env.sh,直接创建项目需要的虚拟环境和安装相关依赖。注意目前env.sh中支持的发行版是CPythonAnaconda,如果Python发行版 是其它,那么可能需要修改env.sh文件中安装virtualenv的命令.虚拟环境默认安装在项目根目录,文件夹是.env。执行source env.sh会默认安装所有项目需要的依赖。
  • 如果不熟悉虚拟环境,可以通过在项目根目录执行pip install -r requirements.txt。这里celery版本用的3.1.25,目的是兼容windows用户。 如果你是linux或者mac用户,建议将celery版本升级成4.x。特别注意,Windows平台上Celery的定时功能不可用!所以如果需要用到定时任务分发的话,请务必将beat部署到linux或者mac上.
  • 打开配置文件修改数据库相关配置。如果你的账号不是常用地登录 的话(比如通过淘宝购买),登录会出现验证码,目前本项目通过打码平台进行验证码识别,选择的打码平台 是云打码,你需要在spider.yaml设置云打码平台你所注册 的用户名和密码并进行适当充值。一块钱大概可以识别160个验证码。也可以选择别的打码平台,又好用的欢迎推荐 T.T
  • 先手动创建一个名为weibo的数据库,然后在项目根目录下,运行python create_all.py创建该项目需要的数据库表

上面其实已经介绍完整个项目的配置流程了.如果大家对docker比较熟悉,也可以使用基于docker的方式进行部署。 如果大家有使用docker的经验,估计也不用我多说了吧,只是要注意一点,构建镜像的时候需要在项目的根目录,因为在构建 镜像的过程中会拷贝WeiboSpider整个项目,目前用的硬编码,除了挂载可以灵活一点也没找到别的办法。镜像构建语句可以 是

docker build -f WeiboSpider/Dockerfile -t resolvewang/weibospider:v1.0 .

构建好镜像后运行容器默认是接受所有任务路由,如果只接收部分,直接覆盖CMD的命令即可,比如我只想执行login任务,那么

docker run --name resolvewang/weibospider:v1.0 celery -A tasks.workers -Q login_queue worker -l info -c 1

又比如通过docker启动定时器

docker run --name spiderbeater resolvewang/weibospider:v1.0 celery beat -A tasks.workers -l info

使用

  • 入口文件:如果有同学有修改源码的需求,那么建议从入口文件开始阅读
  • login.pylogin_first.py:PC端微博登陆程序
  • user.pyuser_first.py:微博用户抓取程序
  • search.pysearch_first.py:微博话题搜索程序
  • home.pyhome_first.py:微博用户主页所有微博抓取程序
  • comment.pycomment_first.py:微博评论抓取
  • repost.pyrepost_first.py:转发信息抓取

  • 基本用法:请先在数据库中添加基本数据,然后再按照启动各个节点的worker -> 运行login_first.py -> 启动定时任务或者别的任务这个顺序进行,下面是详细说明

  • 在分布式节点上启动worker。需要在启动worker的时候指定分布式节点的queue,queue的作用是配置节点可以接收什么任务,不可以接收什么任务。 比如我需要在节点1执行登录和用户抓取任务,那么启动worker的语句就是celery -A tasks.workers -Q login_queue,user_crawler worker -l info -c 1。如果不指定-Q参数, 即运行celery -A tasks.workers worker -l info -c 1,那么所有任务都能够在该节点执行。所有的queue及作用和更多关于worker的知识请 在wiki中查看
  • celery运行定时任务会延迟一个定时周期。如果是第一次运行该项目,为了在抓取任务运行之前能有cookies,需要在任意一个节点上,切换到项目根目录执行pythonlogin_first.py获取首次登陆的cookie, 需要注意它只会分发任务到指定了login_queue的节点上或者未指定 -Q的节点上
  • 在其中一个分布式节点上,切换到项目根目录,再启动定时任务(beat只启动一个,否则会重复执行定时任务): celery beat -A tasks.workers -l info。因为beat任务会有一段时间的延迟(比如登录任务会延迟20个小时再执行),所以第二步要通过python login_first.py来获取worker 首次运行需要的cookies.如果你想马上启动其他任务,而非等定时任务启动,那么可以执行相应的 *.first.py,比如我想在worker启动和login_first.py执行后就执行用户抓取任务,那么就通过 python user_first.py来执行
  • 通过flower监控节点健康状况:先在任意一个节点,切换到项目根目录,再执行flower -A tasks.workers,通过'http://xxxx:5555' 访问所有节点信息,这里的xxxx指的是节点的IP. 如果需要让外网访问,可以这样celery -A tasks.workers flower --address=0.0.0.0 --port=5555
  • 程序默认以普通模式运行,如果想改成极速模式,请修改配置文件mode的值为quick。关于极速和普通模式的区别, 请查看wiki
  • 注意,请在release页面下载稳定版本的微博爬虫,master分支不保证能正常和稳定运行

  • 其它

  • 定时登录是为了维护cookie的时效性,据我实验,PC端微博的cookie有效时长为24小时,因此设置定时执行登录的任务频率必须小于24小时,该项目默认20小时就定时登录一次
  • 为了保证cookie的可用性,除了做定时登录以外(可能项目代码有未知的bug),另外也从redis层面将cookie过期时间设置为23小时,每次更新cookie就重设过期时间
  • 如果读了上述配置说明还不能顺利运行或者运行该项目的时候出了任何问题,欢迎提issue或者添加QQ群(群号是:499500161, 暗号是:微博爬虫)询问
  • 如果项目某些地方和你的应用场景不符,可以基于已有代码进行定制化开发,阅读代码结构以帮助你快速了解代码的组织方式和核心内容
  • 由于部分同学反映,数据库表有些字段不能见闻知义,所以添加了数据库表字段设计说明

常见问题 :question:

1.问:项目部署好复杂啊,我也没有多台机器,我可以单机运行吗?

答:可以单节点运行。除了单节点,也可以通过单机运行,单机运行的话,需要对代码做少许修改。主要修改方法是找到你需要的功能的入口文件, 然后跟着改,需要改的地方是@app.task这些函数的代码。以登录为例,如果需要单机登录的话,那么就先到login模块 中把send_task()这条语句去掉,直接改成调用login_task()函数即可。这里send_task()是网络调用,修改后就成了本地调用了

2.关于redis的问题:为什么我在给redis设置密码后,并且把redis设置成了守护进程,但是没起作用?

答:其实这个问题和项目关系不是特别大吧。。。不过考虑到有的同学并不熟悉redis,我这里还是阐明一下, 如果在linux上面搭redis的话,当我们修改了redis.conf文件后,我们在启动redis的时候也需要指定redis.conf 文件,启动之前,最好把redis-server加入到环境变量中。比如我的redis.conf放在/etc/redis中, 那么我可以通过先切换到/etc/redis目录,再通过redis-server redis.conf来启动redis server,也可以 直接redis-server /etc/redis/redis.conf来启动,前提是 redis-server文件需要在环境变量中.另外,还得 注意一点,如果是centos的话,redis3.2.7可能会在make&&make install 阶段报错,建议下载redis3.2.8

3.这个项目的模拟登陆和抓取的时候是怎么处理验证码的啊?

答:这个项目在模拟登陆阶段会判断账号是否需要验证码,对于需要验证码的账号,通过打码平台识别验证码进行 操作,我选择的是云打码;对于微博账号抓取的时候被封出现的验证码,目前的处理是从数据库和 redis中删除该账号对应的信息,因为要复现登录后被封需要一些时间来测试,并且某些情况下会验证手机,而某些情况只是识别验证码,这个 还需要进一步求证。

另外,我们应该尽量规避验证码,比如模拟登陆的时候尽量在账号常用地登录,还有一个点就是测试微博的容忍边界,小于它的阈值做采集 就不容易被封(不过速度很慢),毕竟按规矩来被封的风险要小得多。如果有图形图像识别的牛人解决了验证码的问题,欢迎提PR,帮助更多人。

4.这个项目能在windows上执行吗?

答:window上可以执行worker节点,但是不能执行beat节点(即定时任务)。如果要混用windows和linux,那么一定要将celery版本 降级为3.1.25,且将beat节点部署到linux服务器上。

5.这个项目一天能抓多少数据?

答:如果使用极速模式,3台机器每天可抓上百万的用户信息,可抓上千万的微博信息,它的代价就是账号必然会被封,推荐在网上购买小号进行 抓取。如果采用普通模式,那么三台机器每天可抓大概几万条用户信息,账号较为安全。另外,还有一点是,微博搜索的限制比较严格,速度可能 会比抓用户信息和抓用户主页微博慢,这点可能在后面会针对不同需求的用户进行相应处理。

6.这个项目搜索抓到的数据怎么和手动搜索的数据量不一致?

答:不一致主要是因为搜索是用的高级搜索,默认只搜索原创微博,而用户手动去搜索是搜索的所有微博,包括转发的,所以数据量上会有出入, 如果要抓取所有微博,那么修改search模块urlhome模块中的home_url的值即可。

7.可以为这个项目做个web监控和管理页面吗?

答:其实这个需求不是必须的,并且flower已经提供了类似的功能了。使用flower,我们可以监控各个节点的健康状况,且可以看到执行的任务情况

其它说明 :heavy_exclamation_mark:

  • 本项目运行环境是Python3.x,由于Py2和Py3关于字符编码完全不同,所以如果需要在Py2上运行该程序,需要修改解析模块的相关代码
  • 建议使用linux或者mac作为worker节点,windows平台也可以作为worker节点,但是一定不能作为beat节点,并且celery版本要注意一致。
  • 目前该项目已经抓取将近三十万条微博用户数据,如果有需要数据的同学,可以开issue。我是打算数据量大了过后再进行分享。
  • 目前项目有普通抓取和极速抓取两种模式,细节请查看分布式微博爬虫的普通模式与极速模式
  • 建议每台机器上都指定queue,目前发现如果启动worker的时候只指定-c 1 -l info而不指定-Q的话,可能运行会出现问题
  • 如果不需要登录的模块建议就别使用cookie进行抓取,因为这样账号的负载更小。至于哪些信息不需要登录,且是有价值的,这个还会再进行调研,和等待用户的反馈。
  • 如果是开发版,可能会存在运行出问题的情况,所以建议通过release页面下载稳定版
  • 文档方面,目前在WiKi中有一些较为系统的知识。如果使用过程中遇到问题,可以给该项目提issue, 也可以加QQ群交流,群号是:499500161, 暗号是:微博爬虫。注意加群务必备注信息,否则将视为广告而拒绝!
  • 项目维护者目前只有我一个人,所以功能更新速度可能会比较慢,目前我只会关注自己会用到或者觉得有趣的部分,有别的需求的朋友可以提feture,如果恰巧也懂Python,欢迎提PR
  • 如果试用了本项目,觉得项目还不错的,麻烦多多宣传啦。觉得项目太渣或是大家有一些有意义、有趣的想法,欢迎 拍砖、吐槽或者提PR,作者接受一切有意义的建议和提问。另外,随手点个star也是对本人工作的肯定和鼓励:kissing_heart:, 作者也接受捐赠:laughing:。送人玫瑰,手有余香:blush:。

TODO :dart:

  • 微博内容抓取相关
  • [x] 模拟登陆,账号请放置在login_info表中,如果账号登陆时需要验证码,请在云打码官网注册一个云打码用户账号,并进行适当充值
  • [x] 微博常见用户和企业用户信息抓取:通过粉丝和关注进行增量式抓取,起始种子(微博用户uid)请插入seed_ids
  • [x] 微博搜索功能,搜索词由自己指定
  • [x] 指定用户的主页:主要是原创微博内容,你也可以修改文件home.py中的home_urlajax_home_url中的is_ori=1is_all=1来 抓取用户的所有微博。目前指定用户是基于已有的seed_ids表中的home_crawled=0的用户,你也可以自己指定想要抓取的用户。
  • [x] 指定微博的评论:主要是抓取针对该微博的评论,即根评论。你可以通过修改comment.py中的get_comment_list() 来抓取指定微博的所有评论,包括根评论和子评论。目前抓取的评论是从weibo_data表中选取的comment_crawled=0的微博,你可以指定微博mid来定制化爬取评论。
  • [x] 指定微博的转发情况:主要是热门微博的转发信息

  • 反爬虫相关

  • [x] 测试单机单账号访问阈值,这个问题和下面一个问题可以参考 issue#17issue#18
  • [x] 测试单机多账号访问效果
  • [x] 验证不同模块,微博系统的容忍度是否相同
  • [x] 验证登录状态的cookies和代理ip是否可以成功抓取:测试结果是可以使用登录后的cookie 从别的地方进行数据采集,根据这一点,可以考虑使用代理IP,但是代理IP的质量和稳定性可能会 有问题,可能需要找一个或者自己写一个高可用的代理池,这一点还有待考察)
  • [x] 验证移动端登录Cookie和PC端是否可共享,如果可以共享则为PC端大规模抓取提供了可能,因为基于 移动端的异地模拟登陆难度比PC端要小。目前异地账号使用打码平台进行验证码识别,并未采用移动端的方式登录
  • [x] 比较单IP和单账号哪个的限制更多,从而制定更加高效的数据采集方案:测试得知,经常是 账号被封了,然后同一个IP用别的账号还能登陆,所以账号的限制比IP更加严格

  • 其它

  • [x] 优化代码,让程序运行更加快速和稳定:水平有限,已经优化过一次了。下一次可能 要等一段时间了
  • [x] 修复某些时候抓取失败的问题(已添加重试机制)
  • [x] 改成分布式爬虫(使用Celery做分布式任务调度和管理)
  • [x] 完善文档,包括怎么快速创建虚拟环境,怎么安装相关依赖库,怎么使用该项目(请查看三个演示视频(链接: https://pan.baidu.com/s/1kVHUWGv 密码: ydhs)); 讲解celery的基本概念和用法(请查看wiki中关于celery构建分布式爬虫的系列文章); 讲解微博的反爬虫策略(具体请查看issue17issue18); 各个tasks模块的作用和使用方法(请查看wiki中关1task queue说明)。
  • [x] 寻找能解决redis单点故障的方案,有兴趣可以查看我写的这篇文章
  • [x] 完善代码注释,方便用户做二次开发
  • [x] 支持Dockerfile部署项目
  • [ ] 重构项目,以更加Pythonic的方式构建项目

如何贡献 :loudspeaker:

  • 如果遇到使用中有什么问题,可以在issue中提出来
  • 代码中如果有逻辑不合理或者内容不完善的地方,可以fork后进行修改,然后Pull Request,如果一经采纳,就会将你加入contributors, 注意提PR之前,检查一下代码风格是否符合PEP8并且改动的代码已经在自己机器上做了充足的测试(保证能长期稳定运行)
  • 可以实现todo中的需求
  • 欢迎在issue中提有意义的future
  • 希望有仔细研究过微博反爬虫策略的同学积极提建议

点击查看贡献者名单

赞助本项目:thumbsup:

如果本项目确实解决了你的刚需,或者对你有较大的启发,不妨请作者喝杯咖啡或者买本新书。

致谢:heart:

  • 感谢大神Askcelery分布式任务调度框架
  • 感谢大神kennethreitzrequests
  • 感谢提PR和issue的同学,这里特别感谢yun17,为本项目做了大量的贡献
  • 感谢所有捐赠的网友和给star支持的网友

最后,祝大家用得舒心,用着不爽欢迎吐槽!

Core symbols most depended-on inside this repo

decode
called by 19
utils/code_verification.py
get_page
called by 9
page_get/basic.py
_get_statushtml
called by 9
page_parse/status.py
delete_cookies
called by 7
db/redis_db.py
request
called by 5
utils/code_verification.py
freeze_account
called by 5
db/login_info.py
get_encodename
called by 5
wblogin/login.py
get_user_detail
called by 4
page_get/user.py

Shape

Function 161
Method 54
Class 16

Languages

Python100%

Modules by API surface

test_wbspider.py25 symbols
config/conf.py19 symbols
page_parse/status.py15 symbols
db/redis_db.py15 symbols
page_parse/user/public.py12 symbols
db/models.py12 symbols
wblogin/login.py11 symbols
utils/code_verification.py11 symbols
decorators/decorator.py11 symbols
utils/util_cls.py8 symbols
page_parse/home.py8 symbols
db/wb_data.py7 symbols

Dependencies from manifests, versioned

PyMySQL0.7.11 · 1×
PyYAML3.12 · 1×
SQLAlchemy1.1.9 · 1×
bs40.0.1 · 1×
celery4.1.0 · 1×
flower0.9.1 · 1×
redis2.10.5 · 1×
requests2.13.0 · 1×
rsa3.4.2 · 1×

Datastores touched

(mysql)Database · 1 repos

For agents

$ claude mcp add weibospider \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact