Gecco Save

Easy to use lightweight web crawler(易用的轻量化网络爬虫)

Project README

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

  • Easy to use, use jQuery style selector to extract elements
  • Support for asynchronous Ajax requests in the page
  • Support page JavaScript variable extraction
  • Using Redis to realize distributed crawling,reference gecco-redis
  • Support the development of business logic with Spring,reference gecco-spring
  • Support htmlunit extension,reference gecco-htmlunit
  • Support extension mechanism
  • Support download UserAgent random selection
  • Support the download proxy server randomly selected

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!

Open Source Agenda is not affiliated with "Gecco" Project. README Source: xtuhcy/gecco
Open Issues
Last Commit
1 month ago

Open Source Agenda Badge

Open Source Agenda Rating