风铃虫是一款轻量级的爬虫工具，似风铃一样灵敏，如蜘蛛一般敏捷，能感知任何细小的风吹草动，轻松抓取互联网上的内容。它是一款对目标服务器相对友好的蜘蛛程序，内置了二十余种常见或不常见的浏览器标识，能够自动处理cookie和网页来源信息，轻松绕过服务器限制，智能调整请求间隔时间，动态调整请求频率，防止对目标服务器造成干扰。此外，风铃虫还是一款对普通用户十分友好的工具，它提供的大量链接提取器和内容提取器让用户可以随心所欲地快速配置，甚至于只要提供一个开始请求地址就能配置出自己爬虫程序。同时，风铃虫也开放了许多自定义接口，让高级用户能够根据需要自定义爬虫功能。最后，风铃虫还天然支持分布式和集群功能，让你突破单机环境的束缚，释放出你的爬虫能力。可以说，风铃虫几乎能抓取目前所有的网站里的绝大部分内容。
【声明】 请勿将风铃虫应用到任何可能会违反法律规定和道德约束的工作中,请友善使用风铃虫，遵守蜘蛛协议，不要将风铃虫用于任何非法用途。如您选择使用风铃虫即代表您遵守此协议，作者不承担任何由于您违反此协议带来任何的法律风险和损失，一切后果由您承担。
快速使用
<dependency>
<groupId>com.yishuifengxiao.common</groupId>
<artifactId>crawler</artifactId>
<version>2.3.0</version>
</dependency>
交流 QQ 群 : (群号 624646260)
简单使用
提取雅虎财经的内容页的电子货币的名字
// 创建一个提取属性规则
// 该提取规则标识XPATH表示使用XPATH提取器进行提取，
// 该XPATH提取器的XPATH表达式为 //h1/text() ， 该提取提取器的作用顺序是0
ExtractFieldRule extractFieldRule = new ExtractFieldRule(Rule.XPATH, "//h1/text()", "", 0);
// 创建一个提取项
ExtractRule extractRule = new ExtractRule();
extractRule
// 提取项代码，不能为空,同一组提取规则之内每一个提取项的编码必须唯一
.setCode("code")
// 提取项名字，可以不设置
.setName("加密电子货币名字")
// 设置提取属性规则
.setRules(Arrays.asList(extractFieldRule));
// 创建一个风铃虫实例
Crawler crawler = CrawlerBuilder.create()
// 风铃虫的起始链接
.startUrl("https://hk.finance.yahoo.com/cryptocurrencies")
// 风铃虫会将请求到的网页中的URL先全部提取出来
// 然后将匹配链接提取规则的链接过滤出来，放入请求池中
// 请求池中的链接会作为下次抓取请求的种子链接
// 可以以添加多个链接提取规则，多个规则之间是并列(或连接)的关系
// 如果不设置则表示提取链接中所有包含域名关键字（例如此例中的yahoo）的链接放入链接池
// 此例中表示符合该正则表达式的链接都会被提取出来
.addLinkRule(new MatcherRule(Pattern.REGEX, "https://hk.finance.yahoo.com/quote/.+"))
// 内容页地址规则是告诉风铃虫哪些页面是内容页
// 对于复杂情况下，可以与 内容匹配规则 配合使用
// 只有符合内容页规则的页面才会被提取数据
// 对于非内容页，风铃虫不会尝试从中提取数据
// 此例中表示符合该正则表达式的网页都是内容页，风铃虫会从这些页面里提取数据
.contentPageRule(new MatcherRule(Pattern.REGEX, "https://hk.finance.yahoo.com/quote/.+"))
// 风铃虫可以设置多个提取项，这里为了演示只设置了一个提取项
// 增加一个提取项规则
.addExtractRule(extractRule)
// 请求间隔时间
// 如果不设置则使用默认时间10秒，此值是为了防止抓取频率太高被服务器封杀
.interval(3000)// 每次进行爬取时的平均间隔时间，单位为毫秒，
.creatCrawler();
// 启动爬虫实例
crawler.start();
// 这里没有设置信息输出器，表示使用默认的信息输出器
// 默认的信息输出器使用的logback日志输出方法，因此需要看控制台信息
// 由于风铃虫是异步运行的，所以演示时这里加入循环
while (Statu.STOP != crawler.getStatu()) {
try {
Thread.sleep(1000 * 20);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
上述例子的作用提取雅虎财经的内容页的电子货币的名字，如果用户想要提取其他信息，只需要按照规则配置好其他的提取规则即可。
注意 上述示例仅供学习演示所用，风铃虫使用者在抓取网页内容请严格遵守相关的法律规定和目标网站的蜘蛛协议
风铃虫原理
风铃虫的原理极为简单，主要由 资源调度器、网页下载器、链接解析器、内容解析器、信息输出器 这极大部分组成。
他们的作用与功能如下所示：
- 资源调度器：负责风铃虫资源的调度过程，例如进行任务的储存、任务的调度和任务的管理
- 网页下载器：负责根据调度器调度的任务下载网页资源
- 链接解析器：负责解析网页下载器下载的网页内容，从网页内容中提取出所有符合要求的链接
- 内容解析器：负责对网页下载器下载的网页内容进行内容解析
- 信息输出器：输出内容解析器解析出来的数据
其中的链接解析器是由一系列的链接提取器组合而成，目前链接提取器主要是支持正则提取。
内容解析器由一系列的内容提取器组合而成，不同的内容提取器功能不同，适用于不同的解析场景，支持多个提取器的重复、循环等多种组合形式。
上述个组件均提供了自定义配置接口，使用户可以根据实际需要进行自定义配置，满足各种复杂乃至异常场景的要求。
风铃虫内置的内容提取器有：
- 原文提取器
- 中文提取器
- 常量提取器
- CSS内容提取器
- CSS文本提取器
- 邮箱提取器
- 数字提取器
- 正则提取器
- 字符删除提取器
- 字符替换提取器
- 字符串截取提取器
- XPATH提取器
- 数组截取
- ...
在进行文本内容提取时，用户可以将这些提取器自由组合以提取出自己需要的内容,更多提取器的具体用法请参见 内容提取器用法。
风铃虫内置的浏览器标识有：
- 谷歌浏览器(windows版、linux版)
- Opera浏览器 (windows版、MAC版)
- 火狐浏览器(windows版、linux版、MAC版)
- IE浏览器(IE9、IE11)
- EDAG浏览器
- safari浏览器(windows版、MAC版)
- ...
抓取js渲染网站
核心代码如下：
Crawler crawler = ...
crawler .setDownloader(new SeleniumDownloader("C:\\Users\\yishui\\Desktop\\geckodriver\\win32.exe",3000L))
分布式支持
核心代码如下:
....
//省略其他代码
....
//创建redis资源调度器
Scheduler scheduler=new RedisScheduler("唯一的名字",redisTemplate)
//创建一个redis资源缓存器
RequestCache requestCache = new RedisRequestCache(redisTemplate);
crawler
.setRequestCache(requestCache) //设置使用redis资源缓存器
.setScheduler(scheduler); //设置使用redis资源调度器
....
//省略其他代码
....
//启动爬虫实例
crawler.start();
状态监控
风铃虫还提供了强大的状态监控和事件监控能力，通过 状态监听器和事件监听器，风铃虫让你对任务的运行情况了如指掌，实时掌控实例运行过程中遇到的各种问题，真正做到对任务的运行情况洞若观火，方便运维。
解析模拟器
由于风铃虫的解析功能十分强大，规定定义十分灵活，为了直观地了解已配置的规则定义的作用，风铃虫提供了解析模拟器，让使用者能够快速了解自己设置的规则定义的效果是否符合预期目标，及时调整规则定义，方便风铃虫实例的配置。
风铃虫平台效果演示
- 配置基本信息
配置爬虫的名字、使用的线程数量和超时停止时间
- 配置链接爬取信息
配置爬虫的起始种子链接和从网页里提取下一次抓取时的链接的提取规则
- 配置站点信息
此步骤一般可以省略，但是对于某些会校验cookie和请求头参数的网站，此配置非常有用
- 提取项配置
配置需要从网站里提取出来的数据，例如新闻标题和网页正文等信息
- 属性提取配置
调用内容提取器进行任意组合，以根据需要提取出需要的数据
- 属性提取测试
提前检验提取项的配置是否正确，提取出来的数据是否符合预期目标
相关资源链接
文档地址 :https://gitee.com/zhiyubujian/wind-bell/wikis/pages