← Back to Skills Marketplace
Clearbit
by
aiwithabidi
· GitHub ↗
· v1.0.0
460
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clearbit
Description
Clearbit — person enrichment, company enrichment, prospecting, and reveal (identify website visitors).
README (SKILL.md)
🔮 Clearbit
Clearbit — person enrichment, company enrichment, prospecting, and reveal (identify website visitors).
Requirements
| Variable | Required | Description |
|---|---|---|
CLEARBIT_API_KEY |
✅ | Clearbit API key (or HubSpot Clearbit key) |
Quick Start
# Enrich person by email
python3 {{baseDir}}/scripts/clearbit.py enrich-person --email \x3Cvalue>
# Enrich company by domain
python3 {{baseDir}}/scripts/clearbit.py enrich-company --domain \x3Cvalue>
# Combined person + company lookup
python3 {{baseDir}}/scripts/clearbit.py combined-lookup --email \x3Cvalue>
# Prospect/search for leads
python3 {{baseDir}}/scripts/clearbit.py prospect --query "JSON filter object"
# Reveal company by IP address
python3 {{baseDir}}/scripts/clearbit.py reveal --ip \x3Cvalue>
# Find company domain by name
python3 {{baseDir}}/scripts/clearbit.py name-to-domain --name \x3Cvalue>
Output Format
All commands output JSON by default.
Script Reference
| Script | Description |
|---|---|
{baseDir}/scripts/clearbit.py |
Main CLI — all commands in one tool |
Credits
Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.
📅 Need help setting up OpenClaw for your business? Book a free consultation
Usage Guidance
This skill is internally consistent for Clearbit lookups and appears safe to use, but review and consider the following before installing: 1) The script will try to read a .env file at WORKSPACE/.env or ~/.openclaw/workspace/.env if CLEARBIT_API_KEY is not set — avoid storing unrelated secrets there or set CLEARBIT_API_KEY directly in the environment. 2) The tool makes network requests to Clearbit endpoints (person.clearbit.com); only provide an API key with appropriate, limited permissions and consider a dedicated key. 3) The skill source is from a third party (agxntsix.ai / author claimed in the README); if you do not trust that source, inspect or run the script in an isolated environment. 4) Error responses are printed to stderr (may contain API error details); if you log outputs, be mindful of sensitive content. Overall the footprint is small and behavior matches its description.
Capability Analysis
Type: OpenClaw Skill
Name: clearbit
Version: 1.0.0
The `scripts/clearbit.py` file contains a URL parameter injection vulnerability. User-provided arguments (e.g., email, domain, IP, name) are directly inserted into the URL path string using simple string replacement without proper URL encoding. This allows an attacker to inject arbitrary query parameters into the Clearbit API requests, potentially leading to unexpected behavior or abuse of the third-party API. While this is a significant vulnerability, there is no clear evidence of intentional malicious behavior targeting the agent's system, such as data exfiltration or unauthorized remote control.
Capability Assessment
Purpose & Capability
Name, description, declared env var (CLEARBIT_API_KEY) and implemented functionality align: the script calls Clearbit endpoints for person/company enrichment, prospecting, reveal, and name-to-domain lookups. No unrelated services or credentials are requested.
Instruction Scope
SKILL.md instructs running the bundled CLI and only documents the CLEARBIT_API_KEY requirement. The implementation will additionally attempt to read a .env file from either the path pointed to by WORKSPACE or ~/.openclaw/workspace/.env to find the key if the env var is not set — this behavior is not documented in SKILL.md but is limited to locating the API key. The script makes direct HTTP requests only to Clearbit (person.clearbit.com).
Install Mechanism
No install spec; code is provided as a single Python stdlib-only script. No downloaded archives or external install actions are present, so nothing extra is written to disk beyond the included files.
Credentials
Only CLEARBIT_API_KEY is required (declared as primaryEnv), which is proportionate. However the script will read the WORKSPACE env var (if present) and will open a .env file under that workspace or ~/.openclaw/workspace/.env to extract the key — access to WORKSPACE and reading a .env file are not declared and may be surprising if that .env contains other secrets.
Persistence & Privilege
always is false, the skill does not request persistent installation or modify other skills/configuration. It performs only transient HTTP requests and exits.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clearbit - After installation, invoke the skill by name or use
/clearbit - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Clearbit skill for OpenClaw agents.
- Person and company enrichment, prospecting, and website visitor reveal via Clearbit API.
- Python 3.10+ support with no external dependencies.
- Command-line interface supports lookups by email, domain, IP, and company name.
- Requires CLEARBIT_API_KEY environment variable.
- All commands output results as JSON.
Metadata
Frequently Asked Questions
What is Clearbit?
Clearbit — person enrichment, company enrichment, prospecting, and reveal (identify website visitors). It is an AI Agent Skill for Claude Code / OpenClaw, with 460 downloads so far.
How do I install Clearbit?
Run "/install clearbit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clearbit free?
Yes, Clearbit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Clearbit support?
Clearbit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clearbit?
It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.
More Skills