urllib.robotparser — Парсер robots.txt

Исходный код: Lib/urllib/robotparser.py

Этот модуль предоставляет единственный класс, RobotFileParser, который отвечает на вопросы о том, может ли конкретный пользовательский агент получить доступ к URL на веб-сайте, который опубликовал файл robots.txt. Более подробную информацию о структуре файлов robots.txt см. на странице http://www.robotstxt.org/orig.html.

class urllib.robotparser.RobotFileParser(url='')

Этот класс предоставляет методы для чтения, разбора и ответа на вопросы о файле robots.txt по адресу url.

set_url(url)

Устанавливает URL, указывающий на файл robots.txt.

read()

Читает URL robots.txt и передаёт его парсеру.

parse(lines)

Разбирает аргумент lines.

can_fetch(useragent, url)

Возвращает True, если useragent разрешено получать доступ к url в соответствии с правилами, содержащимися в обработанном файле robots.txt.

mtime()

Возвращает время последнего обращения к файлу robots.txt. Это полезно для долгоживущих веб-пауков, которым нужно периодически проверять наличие новых файлов robots.txt.

modified()

Устанавливает время последнего обращения к файлу robots.txt на текущее время.

crawl_delay(useragent)

Возвращает значение параметра Crawl-delay из файла robots.txt для указанного useragent. Если такого параметра нет, он не применим к указанному useragent или запись robots.txt для этого параметра имеет неверный синтаксис, возвращает None.

Введено в версии 3.6.

request_rate(useragent)

Возвращает содержимое параметра Request-rate из файла robots.txt в виде именованной кортежа RequestRate(requests, seconds). Если такого параметра нет, он не применим к указанному useragent или запись robots.txt для этого параметра имеет неверный синтаксис, возвращает None.

Введено в версии 3.6.

site_maps()

Возвращает содержимое параметра Sitemap из файла robots.txt в виде списка list(). Если такого параметра нет или запись robots.txt для этого параметра имеет неверный синтаксис, возвращает None.

Введено в версии 3.8.

Следующий пример демонстрирует основное использование класса RobotFileParser:

>>> import urllib.robotparser
>>> rp = urllib.robotparser.RobotFileParser()
>>> rp.set_url("http://www.musi-cal.com/robots.txt")
>>> rp.read()
>>> rrate = rp.request_rate("*")
>>> rrate.requests
3
>>> rrate.seconds
20
>>> rp.crawl_delay("*")
6
>>> rp.can_fetch("*", "http://www.musi-cal.com/cgi-bin/search?city=San+Francisco")
False
>>> rp.can_fetch("*", "http://www.musi-cal.com/")
True