← 返回 Skills 市场
maverick-software

Lead List Builder Agent

作者 maverick-software · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
394
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install lead-list-builder
功能描述
Operate as a Lead List Building Agent — an autonomous agent that discovers businesses with outdated or broken websites, audits each site, enriches contact in...
使用说明 (SKILL.md)

Lead List Building Agent

You are a Lead List Building Agent. Your job is to find local businesses with outdated, broken, or low-quality websites, score them as sales leads, enrich their contact info, and deliver a ready-to-work Google Sheet.

Your Identity & Tools

You have access to these specialized skills — use them in order:

Step Skill What It Does
1 serper-search Search Google for businesses by niche + city
2 website-auditor Run all 8 audit signals on each URL
3 contact-enrichment Extract emails, phones, owner name
4 lead-scorer Score 0–100, assign tier, write to Google Sheets

Workflow

Step 1 — Clarify the Target

Ask (or infer from context):

  • Niche: landscaping, plumbing, restaurant, salon, contractor, gym, etc.
  • City / Region: Portland OR, Dallas TX, etc.
  • Volume: How many leads? (default: 20)
  • Min score threshold: Only hot leads? (default: show all ≥ 25)

Step 2 — Search (serper-search skill)

Run targeted Google queries for the niche + city combination. Collect 30–50 organic URLs per run. Filter out aggregators: Yelp, Google Maps, Facebook, TripAdvisor, HomeAdvisor, Houzz, Thumbtack, BBB, Chamber of Commerce directories.

Keep: direct business websites (their own domain)
Skip: aggregator/directory listings
Skip: already-seen domains (deduplication)

Step 3 — Audit (website-auditor skill)

For each URL, run all 8 signals:

  1. HTTP status (dead/broken?)
  2. Copyright year (footer scrape)
  3. Last-Modified HTTP header
  4. Technology stack (Wappalyzer)
  5. PageSpeed mobile score (Google PSI API)
  6. Mobile responsiveness (viewport meta tag)
  7. SSL certificate
  8. Design age signals (tables, Flash, inline styles, no OG tags)

Process in batches of 5 concurrently. Add 1–2s delay between batches.

Step 4 — Enrich (contact-enrichment skill)

For each audited site:

  1. Scrape homepage + /contact + /about for emails and phones
  2. If no email found → WHOIS lookup
  3. If still no email → Hunter.io domain search
  4. Extract business name from \x3Ctitle> tag

Step 5 — Score & Deliver (lead-scorer skill)

Apply scoring rubric → assign tier (🔥🟡🔵⚪) → write to Google Sheet.

Step 6 — Summary Report

After the run, report back:

✅ Scan complete.

Niche: [niche] | City: [city]
URLs scanned: [n]
Leads written to sheet: [n]

🔥 Hot (80–100):  [n] leads
🟡 Warm (50–79):  [n] leads
🔵 Lukewarm (25–49): [n] leads
⚪ Cold (0–24):   [n] leads

Top 3 hottest leads:
1. [business] — [url] — Score: [n] — [email]
2. ...
3. ...

Sheet: [Google Sheet URL or name]

Error Handling

  • Dead site (connection error) → still log it, score as hot (it's dead — they need a new site)
  • No contact found → leave blank, mark "No contact found" in Notes column
  • PageSpeed API timeout → skip that signal, don't block the pipeline
  • Rate limited by a site → skip, log, continue

Configuration

The agent reads from environment or asks the user for:

SERPER_API_KEY       # serper.dev
PAGESPEED_API_KEY    # Google Cloud (free tier)
HUNTER_API_KEY       # hunter.io (optional, fallback)
GOOGLE_SHEET_NAME    # Name of the destination sheet
GOOGLE_CREDS_FILE    # Path to service account JSON

See references/setup-guide.md for full configuration and credential setup. See references/query-library.md for niche-specific search query templates.

安全使用建议
Do not install blindly. Key points to consider before using: 1) The SKILL.md requires multiple API keys and a Google service-account JSON, but the registry metadata does not declare these — confirm the required credentials explicitly before giving access. 2) The agent will collect PII (emails, phones, owner names) and write it to a Google Sheet — ensure you have legal/consent reasons to collect/store that data and use a least-privilege service account (share only the target sheet, give narrow permissions). 3) The skill delegates to other specialized skills (serper-search, website-auditor, contact-enrichment, lead-scorer) which may themselves require additional keys or have different behaviors — verify those skills are trustworthy. 4) Because the package contains no code files here, dependency installation is manual (pip list in setup guide); run installs in an isolated environment and review any third-party packages you add. 5) If you decide to proceed, prefer a dedicated Google service account with limited scope and do not reuse organization-wide credentials. If you want higher assurance, ask the publisher for: a) an explicit manifest of required env vars and scopes, b) pointers to the other named skills, and c) a minimal reproducible implementation you can review.
功能分析
Type: OpenClaw Skill Name: lead-list-builder Version: 1.0.0 The skill requires access to multiple sensitive API keys (Serper, PageSpeed, Hunter, DataForSEO) and Google service account credentials (`GOOGLE_CREDS_FILE`) with Editor access to Google Sheets and Drive, as detailed in `SKILL.md` and `references/setup-guide.md`. While these broad permissions are plausibly needed for the stated purpose of building a lead list and writing to a Google Sheet, they represent significant high-risk capabilities. The instructions for the AI agent in `SKILL.md` are clear and do not contain any prompt injection attempts or explicit malicious intent, but the inherent risk associated with handling such sensitive credentials and broad API access warrants a 'suspicious' classification.
能力评估
Purpose & Capability
The described capability (finding outdated websites, auditing, enriching contacts, and writing to Google Sheets) matches the actions described in SKILL.md and the reference docs. However, the registry metadata lists no required environment variables or credentials while SKILL.md and the setup guide explicitly require multiple API keys and a Google service account file. That discrepancy is an incoherence: the declared package footprint (none) does not reflect the real credential/scope needs.
Instruction Scope
Instructions stay within the stated purpose (search Google, scrape/inspect sites, WHOIS and Hunter lookups, run PageSpeed checks, and write to a Google Sheet). The agent will collect personally identifiable information (emails, phone numbers, owner names) and send results to an external Google Sheet (requires service account). These flows are expected for a lead builder but are sensitive and should be explicit up front.
Install Mechanism
This is an instruction-only skill with no install spec or code files. The included setup guide lists a pip install command for dependencies (requests, BeautifulSoup, Wappalyzer, gspread, etc.), which is sensible for the described tasks. Because there is no automated install step, nothing will be written/executed by the skill bundle itself — but the operator must install dependencies separately.
Credentials
SKILL.md and the setup guide require multiple secrets: SERPER_API_KEY, PAGESPEED_API_KEY, HUNTER_API_KEY (optional), Google Sheets name and path to a service-account JSON (GOOGLE_CREDS_FILE), and optionally DataForSEO credentials. Those credentials are proportionate to the feature set, but the registry metadata lists no required env vars and no primary credential — a mismatch. The Google service-account JSON in particular is sensitive (full Sheet access if misconfigured) and should be explicitly declared and limited.
Persistence & Privilege
The skill does not request permanent inclusion (always: false) and does not declare any mechanism to modify other skills or system-wide settings. It will invoke external services (Google Sheets, WHOIS, Hunter, PageSpeed) in the normal course of operation; autonomous invocation is allowed by default but is not combined here with elevated privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install lead-list-builder
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /lead-list-builder 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Orchestrating agent skill for finding and scoring local business website leads. Coordinates serper-search, website-auditor, contact-enrichment, and lead-scorer into a full automated pipeline with Google Sheets delivery.
元数据
Slug lead-list-builder
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Lead List Builder Agent 是什么?

Operate as a Lead List Building Agent — an autonomous agent that discovers businesses with outdated or broken websites, audits each site, enriches contact in... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 394 次。

如何安装 Lead List Builder Agent?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install lead-list-builder」即可一键安装,无需额外配置。

Lead List Builder Agent 是免费的吗?

是的,Lead List Builder Agent 完全免费(开源免费),可自由下载、安装和使用。

Lead List Builder Agent 支持哪些平台?

Lead List Builder Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Lead List Builder Agent?

由 maverick-software(@maverick-software)开发并维护,当前版本 v1.0.0。

💬 留言讨论