← 返回 Skills 市场
Census
作者
aiwithabidi
· GitHub ↗
· v1.0.0
496
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install census
功能描述
US Census Bureau — population, demographics, ACS data, economic indicators, and geographic data.
使用说明 (SKILL.md)
📊 Census API
US Census Bureau — population, demographics, ACS data, economic indicators, and geographic data.
Requirements
| Variable | Required | Description |
|---|---|---|
CENSUS_API_KEY |
✅ | Census API key (optional) |
Quick Start
# ACS 5-Year estimates
python3 {{baseDir}}/scripts/census.py acs-5yr --get "NAME,B01003_001E" --for "state:*"
# ACS 1-Year estimates
python3 {{baseDir}}/scripts/census.py acs-1yr --get "NAME,B01003_001E" --for "state:*"
# 2020 Decennial Census
python3 {{baseDir}}/scripts/census.py decennial --get "NAME,P1_001N" --for "state:*"
# Population estimates
python3 {{baseDir}}/scripts/census.py population --get "NAME,POP_2022" --for "state:*"
# County Business Patterns
python3 {{baseDir}}/scripts/census.py cbp --get "NAME,ESTAB,EMP" --for "state:*" --naics "72"
# Poverty data
python3 {{baseDir}}/scripts/census.py poverty --get "NAME,B17001_001E,B17001_002E" --for "state:*"
# Median household income
python3 {{baseDir}}/scripts/census.py income --get "NAME,B19013_001E" --for "state:*"
# Housing data
python3 {{baseDir}}/scripts/census.py housing --get "NAME,B25001_001E,B25002_002E,B25002_003E" --for "state:*"
# List available datasets
python3 {{baseDir}}/scripts/census.py list-datasets --year "2022"
# List ACS variables
python3 {{baseDir}}/scripts/census.py list-variables
# List available geographies
python3 {{baseDir}}/scripts/census.py list-geographies
Output Format
All commands output JSON by default.
Script Reference
| Script | Description |
|---|---|
{baseDir}/scripts/census.py |
Main CLI — all commands in one tool |
Credits
Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.
📅 Need help setting up OpenClaw for your business? Book a free consultation
安全使用建议
This skill appears to implement Census API calls and only contacts the official api.census.gov endpoint, but there are mismatches you should resolve before trusting it with credentials. The metadata asks for CENSUS_API_KEY as the primary credential but the script does not attach that key to requests — either the author forgot to use the key (so providing one won't help) or the implementation is incomplete. The script also contains a helper that will read a .env file from WORKSPACE or ~/.openclaw/workspace (and reads WORKSPACE env) even though no config paths are declared; that behavior is currently unused but surprising. Recommendations: (1) Ask the publisher to clarify whether the CENSUS_API_KEY is required and to show how/where it is used (the script should add the key as the 'key' query parameter or equivalent). (2) Ask them to remove or document the .env / WORKSPACE lookup, or declare the config path in metadata. (3) Until clarified, avoid placing any high-privilege or unrelated secrets in the agent environment; only provide a Census API key if you trust the publisher and they demonstrate the key is used for the intended purpose. If you need the functionality but want to be cautious, run the script locally in an isolated environment and inspect network traffic to confirm it only calls api.census.gov.
功能分析
Type: OpenClaw Skill
Name: census
Version: 1.0.0
The skill is designed to interact with the legitimate US Census Bureau API. All network requests are directed to `https://api.census.gov/data`. User inputs are properly handled as URL parameters and encoded, preventing injection vulnerabilities. The `SKILL.md` contains no prompt injection attempts. While the `scripts/census.py` defines a `get_env` function to retrieve `CENSUS_API_KEY` from environment variables or a `.env` file, the key is never actually used in the API calls, which is a functional oversight but not a security vulnerability or malicious act. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation.
能力评估
Purpose & Capability
The script implements Census API endpoints (api.census.gov) appropriate for the skill's name and description. However, the package declares CENSUS_API_KEY as the primary credential but the code never actually uses that key when building requests (no 'key' param or auth header). The SKILL.md even describes the key as 'optional' while metadata marks it required — inconsistent.
Instruction Scope
SKILL.md and Quick Start only instruct running the included script against the Census API (expected). The script contains a helper get_env() that will read an .env file from WORKSPACE or ~/.openclaw/workspace/.env if present — this file access is not documented in SKILL.md and the declared required config paths are 'none'. The get_env() helper is defined but never called, so the behavior is dead code today; nonetheless the presence of undocumented filesystem access is a scope concern and should be clarified or removed.
Install Mechanism
No install spec (instruction-only with a small Python script) and the script uses only Python stdlib and standard HTTPS calls. This is low-risk from an install mechanism perspective.
Credentials
The skill declares a single environment variable CENSUS_API_KEY (primary credential). The code does not consume that environment variable for API requests, and instead contains logic to look for env values inside a .env file under WORKSPACE or ~/.openclaw/workspace (WORKSPACE itself is read from environment). The declared env usage and actual env/file access are inconsistent — the skill asks for a credential it doesn't use and references additional environment/config paths that are not documented in metadata.
Persistence & Privilege
The skill does not request persistent/always-on presence (always:false). It does not modify other skills or system-wide settings in the provided code. No persistence/privilege escalation observed.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install census - 安装完成后，直接呼叫该 Skill 的名称或使用
/census触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Census Skill v1.0.0 — Initial Release
- Adds support for querying US Census Bureau data: population, demographics, ACS data, economic indicators, and geographic data.
- Provides a single CLI tool for accessing multiple Census datasets (ACS, Decennial Census, Population, CBP, Poverty, Income, Housing).
- Outputs results in JSON format.
- Includes commands for listing available datasets, variables, and geographies.
- Requires a Census API key via the CENSUS_API_KEY environment variable.
- No external dependencies; uses Python 3.10+ standard library only.
元数据
常见问题
Census 是什么？
US Census Bureau — population, demographics, ACS data, economic indicators, and geographic data. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 496 次。
如何安装 Census？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install census」即可一键安装，无需额外配置。
Census 是免费的吗？
是的，Census 完全免费（开源免费），可自由下载、安装和使用。
Census 支持哪些平台？
Census 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Census？
由 aiwithabidi（@aiwithabidi）开发并维护，当前版本 v1.0.0。
推荐 Skills