
[Readme in Chinese](https://github.com/code4craft/webmagic/tree/master/README-zh.md)
[](https://maven-badges.herokuapp.com/maven-central/us.codecraft/webmagic-parent/)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://travis-ci.org/code4craft/webmagic)
>A scalable crawler framework. It covers the whole lifecycle of crawler: downloading, url management, content extraction and persistent. It can simplify the development of a specific crawler.
## Features:
* Simple core with high flexibility.
* Simple API for html extracting.
* Annotation with POJO to customize a crawler, no configuration.
* Multi-thread and Distribution support.
* Easy to be integrated.
## Install:
Add dependencies to your pom.xml:
```xml
<dependency>
<groupId>us.codecraft</groupId>
<artifactId>webmagic-core</artifactId>
<version>0.7.5</version>
</dependency>
<dependency>
<groupId>us.codecraft</groupId>
<artifactId>webmagic-extension</artifactId>
<version>0.7.5</version>
</dependency>
```
WebMagic use slf4j with slf4j-log4j12 implementation. If you customized your slf4j implementation, please exclude slf4j-log4j12.
```xml
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</exclusion>
</exclusions>
```
## Get Started:
### First crawler:
Write a class implements PageProcessor. For example, I wrote a crawler of github repository infomation.
```java
public class GithubRepoPageProcessor implements PageProcessor {
private Site site = Site.me().setRetryTimes(3).setSleepTime(1000);
@Override
public void process(Page page) {
page.addTargetRequests(page.getHtml().links().regex("(https://github\\.com/\\w+/\\w+)").all());
page.putField("author", page.getUrl().regex("https://github\\.com/(\\w+)/.*").toString());
page.putField("name", page.getHtml().xpath("//h1[@class='public']/strong/a/text()").toString());
if (page.getResultItems().get("name")==null){
//skip this page
page.setSkip(true);
}
page.putField("readme", page.getHtml().xpath("//div[@id='readme']/tidyText()"));
}
@Override
public Site getSite() {
return site;
}
public static void main(String[] args) {
Spider.create(new GithubRepoPageProcessor()).addUrl("https://github.com/code4craft").thread(5).run();
}
}
```
* `page.addTargetRequests(links)`
Add urls for crawling.
You can also use annotation way:
```java
@TargetUrl("https://github.com/\\w+/\\w+")
@HelpUrl("https://github.com/\\w+")
public class GithubRepo {
@ExtractBy(value = "//h1[@class='public']/strong/a/text()", notNull = true)
private String name;
@ExtractByUrl("https://github\\.com/(\\w+)/.*")
private String author;
@ExtractBy("//div[@id='readme']/tidyText()")
private String readme;
public static void main(String[] args) {
OOSpider.create(Site.me().setSleepTime(1000)
, new ConsolePageModelPipeline(), GithubRepo.class)
.addUrl("https://github.com/code4craft").thread(5).run();
}
}
```
### Docs and samples:
Documents: [http://webmagic.io/docs/](http://webmagic.io/docs/)
The architecture of webmagic (refered to [Scrapy](http://scrapy.org/))

There are more examples in `webmagic-samples` package.
### Lisence:
Lisenced under [Apache 2.0 lisence](http://opensource.org/licenses/Apache-2.0)
### Thanks:
To write webmagic, I refered to the projects below :
* **Scrapy**
A crawler framework in Python.
[http://scrapy.org/](http://scrapy.org/)
* **Spiderman**
Another crawler framework in Java.
[http://git.oschina.net/l-weiwei/spiderman](http://git.oschina.net/l-weiwei/spiderman)
### Mail-list:
[https://groups.google.com/forum/#!forum/webmagic-java](https://groups.google.com/forum/#!forum/webmagic-java)
[http://list.qq.com/cgi-bin/qf_invite?id=023a01f505246785f77c5a5a9aff4e57ab20fcdde871e988](http://list.qq.com/cgi-bin/qf_invite?id=023a01f505246785f77c5a5a9aff4e57ab20fcdde871e988)
QQ Group: 373225642 542327088
### Related Project
* <a href="https://github.com/gsh199449/spider" target="_blank">Gather Platform</a>
A web console based on WebMagic for Spider configuration and management.

芝麻粒儿
- 粉丝: 6w+
- 资源: 2万+
最新资源
- 基于Python及Web技术的园林景观设计理念与案例分享平台源码
- 基于C#语言的MauiGameScoring游戏计分设计源码
- 基于LSTM时间序列预测的MATLAB实现:长短期记忆网络模型,兼容Matlab2021及以上版本,轻松替换数据集即可运行,基于LSTM时间序列预测的MATLAB实现:长短期记忆网络模型替换数据集即刻
- 基于Vue框架的智能家庭网关设计源码仓库
- XYZ轴控制运行方式的案例研究:PLC程序与触摸屏的四种控制策略,案例191号:探索XYZ轴控制的四种运行方式-PLC程序与触摸屏的实践应用案例,案例191号 xyz轴控制运行,有4种方式,P
- 基于rk3568平台的ykt_ndk一卡通设计源码
- python实现消消乐小游戏/基于pygame实现
- 基于Java、Vue等技术的青少年美术协会项目设计源码
- 基于Java+Vue的轻量级网络在线考试系统设计源码
- 双极式PWM驱动直流可逆调速系统建模与仿真:双闭环控制及正反转实现,双极式PWM驱动直流可逆调速系统建模与仿真:双闭环控制及正反转实现,双极式控制直流可逆调速系统matlab仿真 控制良好,看图
- 基于Swift和CoreGraphics的EFQRCode设计源码,支持多平台二维码生成与识别
- Python实现不同视差图计算算法
- MMC模块化多电平逆变器仿真:探讨双闭环控制下的环流抑制与电容电压平衡策略学习参考模型,MMC模块化多电平逆变器:近期仿真分析下的近邻23电平转换技术及其双闭环控制策略实现,兼顾电容电压平衡与环流抑制
- 基于Python、Vue等技术的中国人口数据调查分析与可视化设计源码
- 基于Java平台的智能水肥管理系统设计源码
- 基于Vue框架的众诚土地评估系统设计源码
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈


