← 返回 Skills 市场

LegiScan Bill Search

Name: LegiScan Bill Search
Author: n4cra

作者 n4cra · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

612

总下载

当前安装

版本数

在 OpenClaw 中安装

/install legiscan-bill-search

功能描述

Search and track active or completed state bills by keywords and state using the LegiScan API with customizable filters.

使用说明 (SKILL.md)

LegiScan Bill Tracker\r

\r A skill to monitor state legislative activity using the LegiScan API. It filters for active bills based on custom keywords and state selection.\r \r

Setup\r

API Key: Obtain a free API key from LegiScan.\r
Environment Variable: Set LEGISCAN_API_KEY in your environment.\r
Dependencies: Requires requests.\r \r

Usage\r

\r Run the script directly or via a scheduled task (cron).\r \r

# Default (TX, cryptocurrency keywords)\r
python3 search.py\r
\r
# Custom State and Keywords\r
python3 search.py --state TX --keywords "crypto, bitcoin, blockchain"\r
\r
# Include passed/completed bills\r
python3 search.py --state TX --keywords "crypto, bitcoin, blockchain" --all\r
```\r
\r
## Configuration Options\r
\r
-   `--state`: Two-letter state abbreviation (Default: `TX` or `LEGISCAN_STATE` env var).\r
-   `--keywords`: Comma-separated list of terms to search for.\r
-   `--all`: If flag is present, includes bills that have passed or are completed.\r
\r
## Best Practices\r
- The script uses environment variables for sensitive credentials.\r
- It provides CLI arguments for flexibility without modifying code.\r
- It includes error handling for API failures and missing configuration.

安全使用建议

This skill appears to do only what it claims (query LegiScan and summarize bills), but the package metadata failing to declare the required LEGISCAN_API_KEY is a red flag for sloppy packaging and possible future surprises. Before installing: (1) confirm the skill owner/source (homepage is missing); (2) ensure you will provide a dedicated LegiScan API key (do not reuse high-privilege or shared keys); (3) review the included search.py (you already have it) for any edits or hidden behavior; (4) run it in a limited environment (or inside a container/VM) if you are unsure; and (5) ask the publisher to correct the registry metadata to declare LEGISCAN_API_KEY (and any other required env vars). If the metadata is corrected and the code remains unchanged, the skill is coherent and low-risk for its stated purpose.

功能分析

Type: OpenClaw Skill Name: legiscan-bill-search Version: 1.0.0 The skill bundle is benign. The `search.py` script interacts with the LegiScan API to retrieve legislative bill information, using `requests` for HTTP calls. It securely obtains the API key from the `LEGISCAN_API_KEY` environment variable and does not access any other sensitive files or external domains. The `SKILL.md` documentation is straightforward and contains no prompt injection attempts or instructions for the agent to perform malicious actions. All code and instructions align with the stated purpose of monitoring state legislative activity.

能力评估

ℹ Purpose & Capability

The name/description (search and track state bills via LegiScan) matches what the code does: it queries LegiScan search and bill endpoints and summarizes results. The required dependency (requests) and the CLI flags are appropriate for this purpose. However, the registry metadata lists no required environment variables even though the SKILL.md and code require LEGISCAN_API_KEY (and optionally LEGISCAN_STATE), which is inconsistent.

✓ Instruction Scope

SKILL.md instructs the agent/user to set LEGISCAN_API_KEY, install requests, and run the script or schedule it. The script only performs HTTP GETs to api.legiscan.com and reads only the declared environment variables/CLI args; it does not read arbitrary files, other env vars, or talk to third-party endpoints. Instruction scope stays within the stated purpose.

✓ Install Mechanism

There is no install spec (lowest install risk). The package is delivered as an included Python script; the only runtime dependency is the widely used requests library mentioned in SKILL.md. No downloaded archives or external installers are present.

⚠ Credentials

The code and SKILL.md require a LEGISCAN_API_KEY (and optionally LEGISCAN_STATE), which is proportionate to the function. However, the registry metadata incorrectly lists no required env vars or primary credential—this mismatch could cause confusion or hide that the skill needs a credential. That discrepancy is the main proportionality concern.

✓ Persistence & Privilege

The skill does not request persistent or elevated privileges. always:false and no install hooks or config writes are present. It does not modify other skills or system-wide settings.

如何使用

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

版本历史

v1.0.0

Initial release of LegiScan Bill Tracker skill. - Enables monitoring of state legislative activity via the LegiScan API. - Filters for active bills based on custom keywords and state selection. - Supports command-line configuration for state, keywords, and bill status. - Utilizes environment variables for sensitive data (API key). - Includes error handling for API issues and missing configuration.

元数据

Slug legiscan-bill-search

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题