OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Explorers & Analytics

Etherscan Labels

Etherscan Labels is a Python command-line scraper that collects labeled addresses from Etherscan-family explorers and writes individual and consolidated datasets in JSON and CSV formats. The README lists seven EVM networks, while its documented interactive choices include eth, bsc and poly. It warns that scraping is currently broken because undetected chromedriver is not working.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Etherscan Labels — OpenViST project profile in Explorers & Analytics.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Consider it when you need a locally stored explorer-label dataset and can assess or repair its currently broken scraping dependency.

Who it is for

  • Blockchain researchers assembling address-label datasets.
  • Developers seeking explorer labels in files for their own analytics or monitoring tools.

Documented uses

  • Request a particular explorer label, such as exchange or bridge.
  • Attempt to retrieve all labels for a selected chain.
  • Use exported JSON or CSV labels as input to research or another application.
Before you choose

Requirements & limits

  • The README reports that the scraper is currently broken due to undetected chromedriver.
  • The README documents browser login as a way to prevent popups or missing data and lists optional explorer credentials in configuration.
  • The stated all-label workflow may take more than an hour and can crash.
  • The repository lists seven chains, but its interactive workflow names only eth, bsc and poly.
  • The repository identifies its license as MIT.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Prepare and attempt a label export

Follow the README's setup and retrieval workflow to request a single label or all labels.

Before you start

  • The repository code and Python environment with the listed requirements installed.
  • An account for the selected explorer; the README says logging in prevents popups or missing data.

Steps

  1. From the project folder, install dependencies with pip install -r requirements.txt.

  2. Optionally add ETHERSCAN_USER and ETHERSCAN_PASS to sample.config.json and rename it config.json.

  3. Run python main.py, select a chain, and log into the corresponding explorer account when prompted.

  4. Choose single and enter a label such as exchange, or choose all. The README lists eth, bsc and poly as chain choices.

  5. Check data for individual JSON and CSV files and combined for consolidated JSON label data.

Expected outcome

The intended output is individual label files and consolidated label data in JSON and CSV formats.

Guide limitations

  • The README says the scraper is currently broken because undetected chromedriver is not working; successful retrieval is not established.
  • All-label retrieval is described as taking more than an hour and occasionally crashing.
  • The README's interactive chain choices list only eth, bsc and poly despite listing data for seven chains.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
14 October 2026
Original website title
brianleect/etherscan-labels · Official homepage title · retained in its source language
How we review sourcesSuggest a correction