ci maven

What is Gecco

Gecco is a easy to use lightweight web crawler developed with java language.Gecco integriert jsoup, httpclient, fastjson, spring, htmlunit, redission ausgezeichneten framework,Let you only need to configure a number of jQuery style selector can be very quick to write a crawler.Gecco framework has excellent scalability, the framework based on the principle of open and close design, to modify the closure, the expansion of open.At the same time Gecco is based on a very open MIT open source protocol, whether you are a user or want to jointly improve the Gecco developer, welcome to request pull.If you like the crawler framework,please star or fork!

Main features

Framework overview



Download via Maven



Dependent project


Quick start

@Gecco(matchUrl="{user}/{project}", pipelines="consolePipeline")
public class MyGithub implements HtmlBean {

    private static final long serialVersionUID = -7127412585200687225L;

    private String user;

    private String project;

    @HtmlField(cssPath=".pagehead-actions li:nth-child(2) .social-count")
    private String star;

    @HtmlField(cssPath=".pagehead-actions li:nth-child(3) .social-count")
    private String fork;

    private String readme;

    public String getReadme() {
        return readme;

    public void setReadme(String readme) {
        this.readme = readme;

    public String getUser() {
        return user;

    public void setUser(String user) {
        this.user = user;

    public String getProject() {
        return project;

    public void setProject(String project) {
        this.project = project;

    public String getStar() {
        return star;

    public void setStar(String star) { = star;

    public String getFork() {
        return fork;

    public void setFork(String fork) {
        this.fork = fork;

    public static void main(String[] args) {


The purpose of DynamicGecco is to implement the runtime configuration of the crawl rule without defining the SpiderBean.In fact, the principle is the use of byte code programming, dynamic generation of SpiderBean, but also through the custom GeccoClassLoader to achieve the rule of hot deployment.Below is a simple Demo, more complex Demo can refer to the example below com.geccocrawler.gecco.demo.dynamic.

The following code implements the runtime configuration of the crawl rule:

.gecco("{user}/{project}", "consolePipeline")
.stringField("star").csspath(".pagehead-actions li:nth-child(2) .social-count").text(false).build()
.stringField("fork").csspath(".pagehead-actions li:nth-child(3) .social-count").text().build()
.stringField("contributors").csspath("ul.numbers-summary > li:nth-child(4) > a").href().build()


You can see that the DynamicGecco way compared to the traditional way of annotation code greatly reduced, and a very cool point is DynamicGecco to support the operation of the definition and modification of rules.


教您使用 java 爬虫 gecco 抓取 JD 全部商品信息(一)

教您使用 java 爬虫 gecco 抓取 JD 全部商品信息(二)

教您使用 java 爬虫 gecco 抓取 JD 全部商品信息(三)

集成 Htmlunit 下载页面


一个完整的例子,分页处理,结合 spring,mysql 入库

Similar Tool Comparison

A list of similar tools and how they compare is available here:

Web Archiving Software Comparision

Contact and communication


Gecco 的发展离不开大家支持,扫一扫请作者喝杯咖啡~

支付宝 支付宝


Please follow the open source protocol MIT!