A Python-powered skill for searching and analyzing US campaign finance data, including candidate totals and individual contributions via the FEC API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openfec
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openfec using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenFEC?
OpenFEC is a specialized tool designed to bridge the gap between AI agents and the Federal Election Commission's (FEC) database. By leveraging this skill, developers can programmatically access real-time information regarding political candidates, their financial status, and the committees supporting them. It serves as a critical asset within the Openclaw Skills ecosystem for those conducting political research, financial auditing, or data-driven journalism.
Built with Python 3.10+, the skill is dependency-free and focuses on providing a clean, standard library interface to the FEC API. It enables users to drill down into individual contributions, disbursements, and election results with high precision, making it an essential component for any transparency-focused project.
OpenFEC Use Cases
- Researching political candidate financial histories and cycle-specific totals for campaign analysis.
- Identifying individual contribution patterns by contributor name, state, or specific amount ranges.
- Monitoring committee filings and disbursements to track political spending and compliance.
- Retrieving historical election results and entity-type totals for complex data visualization projects.
How OpenFEC Works
- The user provides a valid FEC API key (or utilizes the DEMO_KEY) to authenticate requests with the official Federal Election Commission API.
- The Python-based script interfaces with various OpenFEC endpoints based on the specific command-line argument invoked.
- The tool processes query parameters such as office type, party affiliation, election cycle, or amount thresholds.
- Structured data is retrieved and returned in a clear JSON format, allowing for immediate ingestion by other tools or AI agents within the Openclaw Skills workflow.
OpenFEC Setup
To get started with OpenFEC, you must first obtain an API key from the FEC website. Once you have your key, follow these steps:
# Export your API key to your environment
export FEC_API_KEY="your_fec_api_key_here"
# Search for a specific candidate
python3 scripts/openfec.py search-candidates --q "Candidate Name" --cycle 2024
# Search for individual contributions over a certain amount
python3 scripts/openfec.py search-contributions --min-amount 1000 --per-page 10
OpenFEC Data Schema & Taxonomy
The skill returns structured JSON data organized by entity. Below is a summary of the data taxonomy:
| Entity | Key Data Fields |
|---|---|
| Candidates | Name, ID, office sought, party affiliation, and election cycle. |
| Committees | Committee name, ID, type, and associated candidate links. |
| Financials | Total receipts, disbursements, and beginning/ending cash on hand. |
| Filings | Document type, receipt date, and coverage periods. |
| Contributions | Contributor name, state, amount, and date of transaction. |
OpenFEC Advanced Features
- Multi-cycle support allowing for comparative financial analysis across different election years.
- Granular disbursement tracking to pinpoint recipient names and specific spending categories.
- Office-specific filtering to isolate results for Presidential, Senate, or House races.
- seamless integration with the AgxntSix Skill Suite for enhanced agent capabilities using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw Architect
The definitive toolkit for designing, configuring, debugging, and optimizing OpenClaw AI agent deployments and Openclaw Skills.
OpenAI Integration
A comprehensive, zero-dependency Python integration for the OpenAI REST API covering text, image, audio, and assistant management.
1Password Connect
A professional-grade integration for managing 1Password vaults, items, and secrets within server-side AI applications.
Mux Video Management
A robust Python CLI tool for programmatically managing Mux video assets, live streams, and engagement metrics.
OpenRouter Toolkit
A comprehensive toolkit for intelligent model routing, cost tracking, and resilient LLM pipelines using OpenRouter.
PagerDuty
A comprehensive PagerDuty integration for managing incidents, schedules, and escalation policies through a high-performance CLI.
Featured*
