Skip to main content

Library for COUNTER-compliant detection of machines and robots.

Project description

https://img.shields.io/github/license/inveniosoftware/counter-robots.svg https://github.com/inveniosoftware/counter-robots/workflows/CI/badge.svg https://img.shields.io/coveralls/inveniosoftware/counter-robots.svg https://img.shields.io/pypi/v/counter-robots.svg

Library for COUNTER-compliant detection of machines and robots.

The purpose behind COUNTER is to enable comparable usage statistics by only reporting genuine user-driven usage for repositories. The purpose behind Code of Practice for Research Data is to split genuine COUNTER user-driven usage into human- and machine-based access.

This Python library implements a tiny API to check if a given user agent string from a browser is considered a robot/crawler/spider or a machine according to the Code of Practice for Research Data [1] as well as the COUNTER Code of Practice.

The library depends on official lists published by both projects. You can see the lists on:

Changes

Version 2025.11 (released on 2025-11-04)

  • chore(setup): update dependencies

  • fix: pkg_resources DeprecationWarning

Version 2025.2 (released on 2025-02-13)

  • User agents lists update.

Version 2018.6 (released on 2018-06-15)

  • Initial public release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

counter_robots-2025.11.tar.gz (9.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

counter_robots-2025.11-py2.py3-none-any.whl (7.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file counter_robots-2025.11.tar.gz.

File metadata

  • Download URL: counter_robots-2025.11.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for counter_robots-2025.11.tar.gz
Algorithm Hash digest
SHA256 624f4c1159ffec041fd96e1420f0698cdd5c0c8ae49ea2d7074c91fe7f90136e
MD5 f005beef53fc4732af34fc7b91336167
BLAKE2b-256 1770e0df8fc6c6940054630b8a31b5d867d863cf3917de9256340af80dd1457d

See more details on using hashes here.

File details

Details for the file counter_robots-2025.11-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for counter_robots-2025.11-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5a04ed0ef280578232ea8b2d7f96877e1617f8161e7742af116786733c1b7b93
MD5 3e985294490047d5f44c907a4ea8f243
BLAKE2b-256 0a29b6226f9c55f29a335ce493c31c8509d4af66cee9e333924cb6b0968a5b95

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page