Click here to Skip to main content
11,922,641 members (53,588 online)
Click here to Skip to main content
Add your own
alternative version


165 bookmarked

A Web Spider Library in C#

, 18 Sep 2007 CPOL
Rate this:
Please Sign up or sign in to vote.
An article about a spider library to grab websites and store them locally

Sample Image - ZetaWebSpider.png

Don't fear, it's just a web spider Wink | ;-)


Today, while looking through some older code, I came across a set of classes I wrote at the beginning of this year for a customer project.

The classes implement a basic web spider (also called "web robot" or "web crawler") to grab web pages (including resources like images and CSS), download them locally and adjust any resource hyperlinks to point to the locally downloaded resources.

While this article is not a full-featured article with detailed explanations as I usually like to write, I still want to put the code online with this short article. Maybe some reader can still take some ideas from this code and use it as a starting point for his own project.


The classes allow for synchronous as well as asynchronous download of the web pages, allowing multiple options to be specified like hyperlink-depth to follow and proxy settings.

The downloaded resources get their own new file names, based on the hash code of the original URL. I did this for simplifications (for me as the programmer).

To parse a document, I am using the SGMLReader DLL from the GotDotNet website.

Also, since I didn't need it for the project I wrote, the library does not care about "robots.txt" or throttling or other features.

Using the Code

The download for this article contains the library ("WebSpider") and a testing console application ("WebSpiderTest"). The testing application is rather short and should be rather easy to understand.

Basically, you do create an instance of the WebSiteDownloaderOptions class, configure several parameters, create an instance of the WebSiteDownloader class, optionally connect event handlers and then tell the instance to either start synchronously or asynchronously processing the given URL.


  • 2007-09-17: Fixed several issues
  • 2006-09-10: Initial release of the article


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Uwe Keim
Chief Technology Officer Zeta Producer Desktop CMS
Germany Germany
Uwe does programming since 1989 with experiences in Assembler, C++, MFC and lots of web- and database stuff and now uses ASP.NET and C# extensively, too. He has also teached programming to students at the local university.

In his free time, he does climbing, running and mountain biking. Recently he became a father of a cute boy.

Some cool, free software from us:

German Developer Community  
Free Test Management Software - Intuitive, competitive, Test Plans. Download now!  
Homepage erstellen - Intuitive, very easy to use. Download now!  
Send large Files online for free by Email

You may also be interested in...

Comments and Discussions

General.STATE File PinPopular
Member 441033831-Oct-09 12:46
memberMember 441033831-Oct-09 12:46 
GeneralMy vote of 1 Pin
babakzawari20-Oct-09 1:23
memberbabakzawari20-Oct-09 1:23 
GeneralWeb Spider Issue Pin
Member 4747242-Sep-09 23:17
memberMember 4747242-Sep-09 23:17 
GeneralRe: Web Spider Issue Pin
Uwe Keim2-Sep-09 23:29
sitebuilderUwe Keim2-Sep-09 23:29 
Generalxml site map Pin
Rohit_kakria10-Aug-09 2:51
memberRohit_kakria10-Aug-09 2:51 
GeneralJust Links [modified] Pin
Sosyopat30-Jul-09 11:18
memberSosyopat30-Jul-09 11:18 
GeneralRe: Just Links Pin
Uwe Keim30-Jul-09 20:22
sitebuilderUwe Keim30-Jul-09 20:22 
GeneralThe remote server returned an error: (403) Forbidden Pin
kakakkakka21-Jul-09 2:00
memberkakakkakka21-Jul-09 2:00 
GeneralRe: The remote server returned an error: (403) Forbidden Pin
Uwe Keim21-Jul-09 2:20
sitebuilderUwe Keim21-Jul-09 2:20 
Generalquestion plz Pin
naroqueen22-May-09 20:22
membernaroqueen22-May-09 20:22 
Generalnice spider and nice code Pin
psyhf21-Mar-09 21:03
memberpsyhf21-Mar-09 21:03 
QuestionI am getting an unhandled exception while running the test project Pin
Member 47118243-Jun-08 10:47
memberMember 47118243-Jun-08 10:47 
GeneralException Running Test Pin
cornix430-Apr-08 10:49
membercornix430-Apr-08 10:49 
Generalso good Pin
okzhuce28-Apr-08 21:18
memberokzhuce28-Apr-08 21:18 
GeneralRe: so good Pin
Uwe Keim28-Apr-08 21:43
sitebuilderUwe Keim28-Apr-08 21:43 
Generalhello Pin
Member 451146418-Feb-08 15:48
memberMember 451146418-Feb-08 15:48 
QuestionVery nice PinPopular
aaron_myers18-Sep-07 5:59
memberaaron_myers18-Sep-07 5:59 
AnswerRe: Very nice Pin
Uwe Keim18-Sep-07 21:37
sitebuilderUwe Keim18-Sep-07 21:37 
GeneralRe: Very nice Pin
aaron_myers22-Oct-07 4:53
memberaaron_myers22-Oct-07 4:53 
QuestionRe: Very nice Pin
babaa24-Feb-08 17:57
memberbabaa24-Feb-08 17:57 
GeneralGreat App Pin
rdissell1-Aug-07 6:14
memberrdissell1-Aug-07 6:14 
GeneralGreat job. But i met a problem Pin
BlueLoveCyn14-Sep-06 22:28
memberBlueLoveCyn14-Sep-06 22:28 
GeneralYour Project No Worky Pin
easy_coder12-Sep-06 4:04
membereasy_coder12-Sep-06 4:04 
GeneralRe: Your Project No Worky Pin
Uwe Keim12-Sep-06 4:19
sitebuilderUwe Keim12-Sep-06 4:19 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.151125.1 | Last Updated 19 Sep 2007
Article Copyright 2006 by Uwe Keim
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid