← Back to Skills Marketplace
merjua14

Gov Permit Scraper

by merjua14 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
275
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gov-permit-scraper
Description
Scrape government permit databases (liquor licenses, business registrations, contractor permits, health permits) to generate B2B sales leads. Enriches raw pe...
README (SKILL.md)

Gov Permit Scraper — Public Records to Sales Pipeline

Turn government permit databases into enriched B2B lead lists with automated outreach.

Pipeline Overview

  1. Scrape — Pull new permits from state/county databases
  2. Filter — Remove irrelevant permits (distributors, manufacturers, renewals)
  3. Enrich — Find business emails via Brave Search + contact page scraping
  4. Store — Append to Google Sheets or CSV with deduplication
  5. Email — Send personalized outreach via Resend/SMTP
  6. Drip — Follow up at day 3 and day 7

Supported Data Sources

Texas (TABC — Liquor Licenses)

  • Source: https://www.tabc.texas.gov/public-information/new-permits-issued/
  • Data: Business name, permit type, address, county, issue date
  • Best for: Insurance agents, POS vendors, food service suppliers

Adaptable to Any State

The scraper pattern works for any government permit database:

  • Contractor licenses
  • Restaurant health permits
  • Real estate licenses
  • Professional licenses (medical, legal, etc.)
  • Business registrations (Secretary of State)

Requirements

  • Brave Search API key — for email enrichment
  • Resend API key (or SMTP) — for outreach emails
  • Google Sheets OAuth (optional) — for lead tracking

Quick Start

# Set environment variables
export BRAVE_API_KEY=your_key
export RESEND_API_KEY=your_key

# Run the TABC pipeline
node scripts/permit-pipeline.js --source tabc --since 2026-03-01

# Dry run (no emails sent)
node scripts/permit-pipeline.js --source tabc --since 2026-03-01 --dry-run

Configuration

Edit scripts/config.json:

  • source: Which permit database to scrape
  • filterKeywords: Permit types to exclude
  • enrichmentMethod: brave | deepcrawl | direct
  • emailTemplate: Customizable pitch template
  • sheetId: Google Sheets ID for lead tracking
  • fromEmail: Sender email address

Scripts

  • scripts/permit-pipeline.js — Main scrape → enrich → email pipeline
  • scripts/config.json — Pipeline configuration

Email Strategy

Initial Outreach (Day 0)

Congratulate on new license, offer relevant service. Keep under 100 words.

Follow-up (Day 3)

Quick bump with one additional value point.

Break-up (Day 7)

Last touch, include social proof or case study link.

References

  • See references/data-sources.md for government database URLs by state
  • See references/compliance.md for CAN-SPAM and cold email legal guidelines
Usage Guidance
This skill appears to do what it says (scrape public permit pages, enrich via Brave, and email via Resend), but before installing you should: (1) review the code yourself or have a developer audit scripts/permit-pipeline.js to confirm no hidden endpoints or extra data collection; (2) be aware you must supply BRAVE_API_KEY and RESEND_API_KEY (and any Google Sheets OAuth) despite the registry metadata claiming none — only provide API keys you trust and rotate them after testing; (3) configure safe sending settings (verified sending domain, rate limits, unsubscribe handling) to avoid abuse or deliverability/legal issues; (4) run first in dry-run mode to confirm behavior and outputs (it supports --dry-run) and check the CSV output and network destinations; (5) if you need higher assurance, ask the publisher why required environment variables are omitted from metadata and request a signed provenance or trusted source for the skill.
Capability Analysis
Type: OpenClaw Skill Name: gov-permit-scraper Version: 1.0.0 The skill is a lead generation tool designed to scrape public government permit data (e.g., Texas TABC), enrich it with business emails via the Brave Search API, and automate outreach using the Resend API. The implementation in `scripts/permit-pipeline.js` is consistent with the stated purpose in `SKILL.md`, uses proper sanitization for API queries, and includes comprehensive documentation on legal compliance (CAN-SPAM/GDPR). No indicators of data exfiltration, unauthorized persistence, or malicious prompt injection were found.
Capability Assessment
ℹ Purpose & Capability
The name/description match the code and SKILL.md: the script scrapes public permit pages, enriches via Brave Search, and sends outreach via Resend/SMTP. However the registry metadata incorrectly lists no required env vars/credentials while the SKILL.md and code require BRAVE_API_KEY and RESEND_API_KEY (and optionally DEEPCRAWL_KEY / Google Sheets OAuth). That metadata mismatch is unexpected and worth flagging.
✓ Instruction Scope
SKILL.md and the script are scoped to scraping public records, enriching via a web search API, storing leads to CSV/Sheets, and sending emails. The runtime instructions and code only reference the project config (scripts/config.json), environment keys for search/email providers, and public government URLs; they do not attempt to read other system files or unrelated credentials.
✓ Install Mechanism
No install spec and no external downloads — the skill is instruction-only with a bundled Node.js script that runs locally. This is lower risk than arbitrary remote install/execution.
⚠ Credentials
The code legitimately requires BRAVE_API_KEY and RESEND_API_KEY (and optionally DEEPCRAWL_KEY and Google Sheets OAuth) to function, which is proportionate to the described functionality. The concern is the registry listing claiming 'no required env vars' — missing declaration increases risk because users may not realize they must supply API keys and may supply them without review. Also the skill performs outbound network calls to third parties (Brave, Resend, potentially DeepCrawl and Google), so any supplied credentials will be used to contact external services.
✓ Persistence & Privilege
always:false and normal autonomous invocation flags. The skill does not request permanent platform-wide privileges and does not modify other skills or system settings. It writes output to local CSV and optionally Google Sheets, which is expected behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gov-permit-scraper
  3. After installation, invoke the skill by name or use /gov-permit-scraper
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Scrape government permit databases into B2B sales leads with auto-enrichment and cold email
Metadata
Slug gov-permit-scraper
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Gov Permit Scraper?

Scrape government permit databases (liquor licenses, business registrations, contractor permits, health permits) to generate B2B sales leads. Enriches raw pe... It is an AI Agent Skill for Claude Code / OpenClaw, with 275 downloads so far.

How do I install Gov Permit Scraper?

Run "/install gov-permit-scraper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gov Permit Scraper free?

Yes, Gov Permit Scraper is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gov Permit Scraper support?

Gov Permit Scraper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gov Permit Scraper?

It is built and maintained by merjua14 (@merjua14); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments