Skip to content

A scalable web crawler framework.

Notifications You must be signed in to change notification settings

codev777/webmagic

Repository files navigation

logo

Readme in Chinese

User Manual (Chinese)

Build Status

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:

 <dependency> <groupId>us.codecraft</groupId> <artifactId>webmagic-core</artifactId> <version>0.4.3</version> </dependency> <dependency> <groupId>us.codecraft</groupId> <artifactId>webmagic-extension</artifactId> <version>0.4.3</version> </dependency> 

Get Started:

First crawler:

Write a class implements PageProcessor:

publicclassOschinaBlogPageProcesserimplementsPageProcessor{privateSitesite = Site.me().setDomain("my.oschina.net"); @Overridepublicvoidprocess(Pagepage){List<String> links = page.getHtml().links().regex("http://my\\.oschina\\.net/flashsword/blog/\\d+").all(); page.addTargetRequests(links); page.putField("title", page.getHtml().xpath("//div[@class='BlogEntity']/div[@class='BlogTitle']/h1").toString()); page.putField("content", page.getHtml().$("div.content").toString()); page.putField("tags",page.getHtml().xpath("//div[@class='BlogTags']/a/text()").all())} @OverridepublicSitegetSite(){returnsite} publicstaticvoidmain(String[] args){Spider.create(newOschinaBlogPageProcesser()).addUrl("http://my.oschina.net/flashsword/blog") .addPipeline(newConsolePipeline()).run()} }
  • page.addTargetRequests(links)

    Add urls for crawling.

You can also use annotation way:

@TargetUrl("http://my.oschina.net/flashsword/blog/\\d+") publicclassOschinaBlog{@ExtractBy("//title") privateStringtitle; @ExtractBy(value = "div.BlogContent",type = ExtractBy.Type.Css) privateStringcontent; @ExtractBy(value = "//div[@class='BlogTags']/a/text()", multi = true) privateList<String> tags; publicstaticvoidmain(String[] args){OOSpider.create( Site.me(), newConsolePageModelPipeline(), OschinaBlog.class).addUrl("http://my.oschina.net/flashsword/blog").run()} }

Docs and samples:

The architecture of webmagic (refered to Scrapy)

image

Javadocs: http://code4craft.github.io/webmagic/docs/en/

There are some samples in webmagic-samples package.

Lisence:

Lisenced under Apache 2.0 lisence

Contributors:

Thanks these people for commiting source code, reporting bugs or suggesting for new feature:

Thanks:

To write webmagic, I refered to the projects below :

Mail-list:

https://groups.google.com/forum/#!forum/webmagic-java

Bitdeli Badge

About

A scalable web crawler framework.

Resources

Stars

Watchers

Forks

Packages

No packages published