example.env

SUPABASE_URL=your_supabase_project_url_here
SUPABASE_KEY=your_supabase_service_role_key_here

# Campaign-finance enrichment (verified spoke). Free key from https://api.data.gov/signup
# (~1,000 req/hour). If unset, the scraper simply skips campaign-donor enrichment.
FEC_API_KEY=your_api_data_gov_key_here

# State-legislature roll-call votes (verified spoke). Free key from
# https://openstates.org/accounts/profile/ (~500 req/day, 10 req/min). If unset, the
# scraper simply skips state voting records.
OPENSTATES_API_KEY=your_openstates_api_key_here

# Congress.gov bill/amendment metadata. Free key from https://api.data.gov/signup.
# If unset, the bounded detail-only reconciliation skips. Private provenance writes
# require a separately reviewed runtime and database opt-in.
CONGRESS_GOV_API_KEY=your_api_data_gov_key_here
CONGRESS_GOV_METADATA_WRITE_MODE=disabled

# Optional unverified LittleSis enrichment for state officials. Keep small and rotate the
# offset between runs. Writes only to unconfirmed_mentions and relationships.
STATE_UNVERIFIED_ENRICHMENT_LIMIT=0
STATE_UNVERIFIED_ENRICHMENT_OFFSET=0

# Official House roll-call writes are defense-in-depth gated. Leave disabled until the
# monotonic-observation migration and production_writes_enabled gate are both reviewed.
HOUSE_ROLL_CALL_WRITE_MODE=disabled
SENATE_ROLL_CALL_WRITE_MODE=disabled

# News aggregator API keys (all optional — GDELT fallback requires no key)
CURRENTS_API_KEY=your_currents_api_key_here        # https://currentsapi.services (account quota varies)
NEWSDATA_API_KEY=your_newsdata_api_key_here        # https://newsdata.io (account credits; attribution required)
THENEWSAPI_KEY=your_thenewsapi_key_here            # https://www.thenewsapi.com (account quota varies)
# Keep disabled until a maintainer confirms the account terms allow this production use.
THENEWSAPI_PRODUCTION_APPROVED=false
NEWSAPI_KEY=your_newsapi_key_here                  # https://newsapi.org (DEV ONLY — not used in production)