ClueWeb-Crawler
Carnegie Mellon University •
Web Crawler
What is ClueWeb-Crawler?
The ClueWeb-Crawler page identifies this as a crawler used by Professor Chenyan Xiong's research group at Carnegie Mellon University's Language Technologies Institute. It describes an academic-research purpose and crawling of public, unauthenticated pages. The published policy says it follows robots.txt and Crawl-delay, with conservative per-host rate limiting.
User Agent String
ClueWeb-Crawler/1.0 (+https://boston.lti.cs.cmu.edu/CMU-ClueWeb-Crawler/; mailto:[email protected])
How to Control ClueWeb-Crawler
Block Completely
To prevent ClueWeb-Crawler from accessing your entire website, add this to your robots.txt file:
# Block ClueWeb-Crawler
User-agent: ClueWeb-Crawler
Disallow: /
Block Specific Directories
To restrict access to certain parts of your site while allowing others:
User-agent: ClueWeb-Crawler
Disallow: /admin/
Disallow: /private/
Disallow: /wp-admin/
Allow: /public/
Set Crawl Delay
To slow down the crawl rate (note: not all bots respect this directive):
User-agent: ClueWeb-Crawler
Crawl-delay: 10
How to Verify ClueWeb-Crawler
Verification Method:
CMU documents the user-agent and says traffic originates from its School of Computer Science IP range; confirm source network ownership rather than trusting the string alone.
CMU documents the user-agent and says traffic originates from its School of Computer Science IP range; confirm source network ownership rather than trusting the string alone.
Learn more in the official documentation.
Detection Patterns
Multiple ways to detect ClueWeb-Crawler in your application:
Basic Pattern
/ClueWeb\-Crawler/i
Strict Pattern
/^ClueWeb\-Crawler\/1\.0 \(\+https\:\/\/boston\.lti\.cs\.cmu\.edu\/CMU\-ClueWeb\-Crawler\/; mailto\:cmu\-clueweb\-crawler@andrew\.cmu\.edu\)$/
Flexible Pattern
/ClueWeb\-Crawler[\s\/]?[\d\.]*?/i
Vendor Match
/.*Carnegie Mellon University.*ClueWeb\-Crawler/i
Implementation Examples
// PHP Detection for ClueWeb-Crawler
function detect_clueweb_crawler() {
$user_agent = $_SERVER['HTTP_USER_AGENT'] ?? '';
$pattern = '/ClueWeb\-Crawler/i';
if (preg_match($pattern, $user_agent)) {
// Log the detection
error_log('ClueWeb-Crawler detected from IP: ' . $_SERVER['REMOTE_ADDR']);
// Set cache headers
header('Cache-Control: public, max-age=3600');
header('X-Robots-Tag: noarchive');
// Optional: Serve cached version
if (file_exists('cache/' . md5($_SERVER['REQUEST_URI']) . '.html')) {
readfile('cache/' . md5($_SERVER['REQUEST_URI']) . '.html');
exit;
}
return true;
}
return false;
}
# Python/Flask Detection for ClueWeb-Crawler
import re
from flask import request, make_response
def detect_clueweb_crawler():
user_agent = request.headers.get('User-Agent', '')
pattern = r'ClueWeb\-Crawler'
if re.search(pattern, user_agent, re.IGNORECASE):
# Create response with caching
response = make_response()
response.headers['Cache-Control'] = 'public, max-age=3600'
response.headers['X-Robots-Tag'] = 'noarchive'
return True
return False
# Django Middleware
class clueweb_crawlerMiddleware:
def __init__(self, get_response):
self.get_response = get_response
def __call__(self, request):
if self.detect_bot(request):
# Handle bot traffic
pass
return self.get_response(request)
// JavaScript/Node.js Detection for ClueWeb-Crawler
const express = require('express');
const app = express();
// Middleware to detect ClueWeb-Crawler
function detect_clueweb_crawler(req, res, next) {
const userAgent = req.headers['user-agent'] || '';
const pattern = /ClueWeb\-Crawler/i;
if (pattern.test(userAgent)) {
// Log bot detection
console.log('ClueWeb-Crawler detected from IP:', req.ip);
// Set cache headers
res.set({
'Cache-Control': 'public, max-age=3600',
'X-Robots-Tag': 'noarchive'
});
// Mark request as bot
req.isBot = true;
req.botName = 'ClueWeb-Crawler';
}
next();
}
app.use(detect_clueweb_crawler);
# Apache .htaccess rules for ClueWeb-Crawler
# Block completely
RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} ClueWeb\-Crawler [NC]
RewriteRule .* - [F,L]
# Or redirect to a static version
RewriteCond %{HTTP_USER_AGENT} ClueWeb\-Crawler [NC]
RewriteCond %{REQUEST_URI} !^/static/
RewriteRule ^(.*)$ /static/$1 [L]
# Or set environment variable for PHP
SetEnvIfNoCase User-Agent "ClueWeb\-Crawler" is_bot=1
# Add cache headers for this bot
<If "%{HTTP_USER_AGENT} =~ /ClueWeb\-Crawler/i">
Header set Cache-Control "public, max-age=3600"
Header set X-Robots-Tag "noarchive"
</If>
# Nginx configuration for ClueWeb-Crawler
# Map user agent to variable
map $http_user_agent $is_clueweb_crawler {
default 0;
~*ClueWeb\-Crawler 1;
}
server {
# Block the bot completely
if ($is_clueweb_crawler) {
return 403;
}
# Or serve cached content
location / {
if ($is_clueweb_crawler) {
root /var/www/cached;
try_files $uri $uri.html $uri/index.html @backend;
}
try_files $uri @backend;
}
# Add headers for bot requests
location @backend {
if ($is_clueweb_crawler) {
add_header Cache-Control "public, max-age=3600";
add_header X-Robots-Tag "noarchive";
}
proxy_pass http://backend;
}
}
Should You Block This Bot?
Recommendations based on your website type:
| Site Type | Recommendation | Reasoning |
|---|---|---|
| E-commerce | Optional | Evaluate based on bandwidth usage vs. benefits |
| Blog/News | Allow | Increases content reach and discoverability |
| SaaS Application | Block | No benefit for application interfaces; preserve resources |
| Documentation | Selective | Allow for public docs, block for internal docs |
| Corporate Site | Limit | Allow for public pages, block sensitive areas like intranets |
Advanced robots.txt Configurations
E-commerce Site Configuration
User-agent: ClueWeb-Crawler
Crawl-delay: 5
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/
Disallow: /api/
Disallow: /*?sort=
Disallow: /*?filter=
Disallow: /*&page=
Allow: /products/
Allow: /categories/
Sitemap: https://example.com/sitemap.xml
Publishing/Blog Configuration
User-agent: ClueWeb-Crawler
Crawl-delay: 10
Disallow: /wp-admin/
Disallow: /drafts/
Disallow: /preview/
Disallow: /*?replytocom=
Allow: /
SaaS/Application Configuration
User-agent: ClueWeb-Crawler
Disallow: /app/
Disallow: /api/
Disallow: /dashboard/
Disallow: /settings/
Allow: /
Allow: /pricing/
Allow: /features/
Allow: /docs/
Quick Reference
User Agent Match
ClueWeb-Crawler
Robots.txt Name
ClueWeb-Crawler
Category
other
Respects robots.txt
Yes
Copied to clipboard!