Skip to content

3GPP Crawler

3GPP Crawler Banner

A command-line tool for crawling the 3GPP FTP server, caching 3GPP document metadata in a local database, and querying structured data via JSON/YAML output.

3gpp-crawler is the main CLI; tdoc-crawler and spec-crawler are shortcuts for the tdoc and spec groups.

Quick Start

# 1. Populate meeting database (REQUIRED first step)
3gpp-crawler meetings crawl

# 2. Crawl TDoc metadata
3gpp-crawler tdoc crawl

# 3. Crawl spec metadata
3gpp-crawler spec crawl

# 4. Query
3gpp-crawler tdoc query --working-group SA --start-date 2024

Documentation

Guides

  • Crawling — Fetch metadata from 3GPP servers and portal.
  • Querying — Search and display stored metadata.
  • Tags — Organize TDocs and specs with lightweight tags.
  • Utilities — Open, checkout, and stats commands.
  • WhatTheSpec — Third-party convenience source for single-TDoc lookups (official sources stay primary).
  • MCP Server — Use 3gpp-crawler from AI agents.
  • Configuration — Config files, environment variables.
  • HTTP Caching & Misc — Caching behavior, credentials.

Development

Reference