# wzdnzd/aggregator

One-stop Proxies Crawling and Aggregation Platform

Repository: https://github.com/wzdnzd/aggregator
Canonical: https://ross.abutalabs.com/products/aggregator
Homepage: https://github.com/wzdnzd/aggregator
Language: Python
License: Apache-2.0
License Family: permissive
Topics: proxypool
Last push: 2026-08-16T00:25:01+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 2641, "days_push": 18, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6754, forks 5485 (observed 2026-08-28T04:09:48.328111+00:00)

## What it is
A Python-based platform that crawls free proxy nodes from sources like Telegram, GitHub, and search engines, validates their liveness, and aggregates them into subscription formats for clients such as Clash, V2Ray, and SingBox. It supports extensible crawling plugins, multi-threaded processing, and pushing results to storage backends like GitHub Gist.

## Use cases
- build a free proxy pool from multiple sources
- collect and validate free proxy subscriptions automatically
- convert proxy nodes to clash v2ray singbox formats
- crawl telegram channels for proxy nodes
- publish aggregated proxy subscriptions to a gist
- check proxy liveness and quality automatically

## When to choose
- you want an automated, multi-source free proxy aggregator with validation and format conversion
- you need scheduled crawling with configurable storage backends and grouping
- you want an extensible plugin architecture for custom crawl sources

## When to avoid
- you need a managed paid proxy service with guaranteed reliability
- you only need a simple proxy client without crawling
- you cannot run Python scripts or scheduled jobs yourself

## Facets
- artifact type: application
- maturity: active
- function: web-scraping, proxy, plugin-system, developer-tools
- domain: privacy, censorship-circumvention, networking
- platform: python, cli, windows
- tags: proxy-pool, proxy-aggregation, subscription-conversion, clash, v2ray, singbox, free-proxies, crawlers, automation, docker, linux, macos

## Member repositories
- wzdnzd/aggregator (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:48.328111+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:42:34.765504+00:00, confidence not recorded.
  - readme: https://github.com/wzdnzd/aggregator (fetched 2026-08-28T04:09:48.328111+00:00, sha ff444e05bfea)
  - homepage: https://github.com/wzdnzd/aggregator (fetched 2026-08-29T08:38:35.168669+00:00, sha 173f50f93a5e)
- Data as of 2026-08-30T08:39:29.467469+00:00.