← 返回 Skills 市场

Broadbandmap Cell Coverage Skill

Name: Broadbandmap Cell Coverage Skill
Author: hobbesoccc

作者 hobbesoccc · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ✓ 安全检测通过

119

总下载

当前安装

版本数

在 OpenClaw 中安装

/install broadbandmap-cell-coverage-skill

功能描述

PRELIMINARY/ITERATING SKILL (v0.x) - Query BroadbandMap-style public APIs for cellular coverage at a location, normalize results, and return a concise human...

使用说明 (SKILL.md)

BroadbandMap Cell Coverage

Status: Preliminary skill (v0.x). This is an intentionally small first release and is expected to evolve quickly.

Use this skill to answer: “How good is cell coverage here?” for a specific location.

Quick workflow

Resolve location to coordinates (lat/lon).
Run scripts/cell_coverage_lookup.py to call the coverage API.
Summarize key results:
- top carriers
- network tech (4G/5G)
- confidence/quality fields if present
Include caveats when API fields are missing or endpoint behavior is unknown.

Run the script

python3 scripts/cell_coverage_lookup.py --lat 39.7392 --lon -104.9903

Default endpoint used by this skill:

GET /api/v1/location/cell?lat={lat}&lng={lng}
Optional filters: network (att|verizon|t-mobile|us-cellular|dish|gci|cellcom|c-spire), tech (4g|5g)

Address mode (uses OpenStreetMap Nominatim geocoding first):

python3 scripts/cell_coverage_lookup.py --address "Denver, CO"

Optional overrides and filters:

python3 scripts/cell_coverage_lookup.py \
  --lat 39.7392 --lon -104.9903 \
  --network verizon \
  --tech 5g \
  --format report

Advanced endpoint overrides:

python3 scripts/cell_coverage_lookup.py \
  --lat 39.7392 --lon -104.9903 \
  --base-url "https://broadbandmap.com" \
  --endpoint "/api/v1/location/cell" \
  --param-lat lat --param-lon lng \
  --api-key "$BROADBANDMAP_API_KEY"

Output contract

The script prints JSON by default with:

input: address/lat/lon used
request: final URL and query params
response: parsed API JSON (or raw body)
summary: best-effort normalized fields (providers, technologies, notes)
errors: any recoverable errors

Use --format report for a concise human-readable output.

Example commands

# Basic lookup by address
python3 scripts/cell_coverage_lookup.py --address "Austin, TX" --format report

# Filter to one network and 5G only
python3 scripts/cell_coverage_lookup.py --address "Seattle, WA" --network verizon --tech 5g --format report

# Raw JSON for automation/pipelines
python3 scripts/cell_coverage_lookup.py --lat 34.0522 --lon -118.2437 --format json

Known limitations

This skill is a preliminary v0.x release and will be iterated/enhanced.
API is alpha and may change schema/limits without notice.
Default public limit is low (~60 requests/hour/IP).
Coverage maps are modeled estimates and may differ from real-world signal.

Response style

When replying to users:

Start with a one-paragraph answer.
Then list providers/technologies in bullets.
End with one caveat sentence: coverage maps are estimates and real-world signal may vary.

references/

Read references/api-notes.md when endpoint details need adjustment.

安全使用建议

This skill appears to be what it says: a small, configurable Python client that geocodes an address and queries a cell-coverage API, then summarizes results. Before installing or using it, consider: (1) If you supply an API key (BROADBANDMAP_API_KEY), only use it with trusted base URLs — the script will send that key as Authorization/x-api-key to whatever base-url is configured. (2) The script performs network calls (OpenStreetMap geocoding and the target API), so location queries will be sent to those services. (3) There are no unexpected filesystem or credential requirements. If you want to be conservative, avoid setting a broad-scope BROADBANDMAP_API_KEY in shared environments and only pass a key when calling trusted endpoints.

功能分析

Type: OpenClaw Skill Name: broadbandmap-cell-coverage-skill Version: 0.1.0 The skill is a legitimate utility for querying cellular coverage data based on location. It uses a Python script (scripts/cell_coverage_lookup.py) to geocode addresses via OpenStreetMap and fetch data from a configurable API (defaulting to broadbandmap.com). The code follows standard practices, uses built-in libraries, and contains no evidence of data exfiltration, malicious execution, or prompt injection.

能力评估

✓ Purpose & Capability

Name, description, SKILL.md, and the included Python script all align: they resolve a location, call a configurable coverage API, normalize provider/technology fields, and return a JSON or human report. No unrelated binaries, credentials, or system resources are requested.

ℹ Instruction Scope

SKILL.md only instructs running the included script and reading the optional BROADBANDMAP_* env vars. The script performs network calls (OpenStreetMap Nominatim geocoding and the configured coverage API) which is expected. Note: the script allows overriding base URL/endpoint; if a user/agent supplies a malicious base-url, requests (and any supplied API key) could be sent to that host.

✓ Install Mechanism

No install spec — instruction-only plus a small Python script. No downloads, package installs, or archives; nothing is written to disk beyond the included script at install time.

ℹ Credentials

No required credentials declared in registry metadata. The code does read optional env vars (BROADBANDMAP_API_KEY, BROADBANDMAP_API_BASE, BROADBANDMAP_API_ENDPOINT). This is proportionate for a configurable API client, but users should be careful about placing sensitive keys in environment variables if they will also override the base URL.

✓ Persistence & Privilege

always is false and the skill does not modify system or other-skill configurations. It performs network I/O only when invoked and does not request persistent platform privileges.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install broadbandmap-cell-coverage-skill
安装完成后，直接呼叫该 Skill 的名称或使用 /broadbandmap-cell-coverage-skill 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

- Initial release of broadbandmap-cell-coverage skill (v0.1.0). - Provides location-based cell coverage lookup using BroadbandMap-style public APIs. - Supports flexible queries by address or lat/lon with optional network and technology filters. - Normalizes API results and returns both concise human summaries and raw JSON output. - Includes simple CLI workflow, default endpoint, response contract, and usage examples. - Notes preliminary status, known API limitations, and response style guidelines.

元数据

Slug broadbandmap-cell-coverage-skill

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题