Note for AI agents: This file and other files in this skill folder may be truncated when opened. Always read files fully in chunks if necessary to ensure no instructions, endpoints, or examples are missed.
A skill that lets subscribers query the SMB Sales Boost lead database using natural language. Search, filter, and export newly registered small and medium businesses across the United States with comprehensive company data including contact information, location, and AI-enriched categories.
Place the smb-sales-boost/ folder in your skills directory:
<workspace>/skills/smb-sales-boost/
├── SKILL.md # Skill instructions (with OpenClaw metadata)
├── smb_api.py # Reusable API client (handles all endpoints + safe exports)
├── openapi.json # Full OpenAPI 3.1 specification (reference)
└── README.md # This file
- Active SMB Sales Boost subscription: Starter, Growth, Scale, Platinum, or Enterprise
- API key generated from Dashboard > API tab (keys start with
smbk_) - Base URL:
https://smbsalesboost.com/api/v1 - New users can purchase a subscription entirely via API — no web signup required
The skill declares SMB_SALES_BOOST_API_KEY as a required env var via metadata.openclaw.requires.env and primaryEnv in the SKILL.md frontmatter. Configure it in ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"smb-sales-boost": {
"enabled": true,
"apiKey": { "source": "env", "provider": "default", "id": "SMB_SALES_BOOST_API_KEY" },
"env": {
"SMB_SALES_BOOST_API_KEY": "smbk_your_key_here"
}
}
}
}
}Alternatively, export the env var in your shell before starting OpenClaw:
export SMB_SALES_BOOST_API_KEY="smbk_your_key_here"The smb_api.py script also accepts the key as its first CLI argument or reads from the SMB_SALES_BOOST_API_KEY env var automatically.
Starter, Growth, and Scale plans use a credit-based model where each new lead queried or exported costs 1 credit:
- Each new lead returned by
GET /leads(search/query) deducts 1 credit - Each net-new lead in a
POST /leads/export(export) deducts 1 credit - Previously-exported leads are free to re-query or re-export
- Both endpoints support
maxCredits(cap spending) andmaxResults(cap total leads) parameters for credit-optimized ordering - Set
maxCredits=0on either endpoint to only receive previously-exported leads at no cost - Purchase additional permanent credits anytime via
POST /purchase-credits - Configure automatic top-ups via
PATCH /auto-top-up
Credit Pricing & Allocations:
| Plan | Per Credit | Monthly Credits | Max Purchase/Transaction |
|---|---|---|---|
| Starter | $0.10 | 500 | 2,500 |
| Growth | $0.075 | 2,000 | 10,000 |
| Scale | $0.05 | 10,000 | 50,000 |
| Platinum | $0.03 | 100,000 | 500,000 |
| Enterprise | $0.02 | 250,000 | 1,250,000 |
SMB Sales Boost provides two separate lead databases with different contact information:
- Home Improvement (
home_improvement) — Home improvement/contractor businesses with phone numbers, star ratings, review counts, review snippets, profile URLs, and categories - Other (
other) — General newly registered businesses with phone numbers and email addresses, registered URLs, crawled URLs, descriptions, redirect status, and AI-enriched category estimations
The Home Improvement database provides phone numbers as the primary contact method. The Other database provides both phone numbers and email addresses, making it ideal for cold email and multi-channel outreach campaigns.
Each database has different filterable fields. Users can switch between databases via POST /settings/switch-database with smbType field (cooldown period applies). Leads in the Other database are progressively enriched with AI category estimations (1-3 categories per lead, stored in the AI Categories field).
Lead field keys use display names with spaces (e.g., Company Name, Phone Primary, AI Categories, Last Updated). The two databases return different schemas (HomeImprovementLead vs OtherLead).
Once the skill is installed, users can interact with SMB Sales Boost in natural language:
- Search with wildcards: "Find new dental practices in Texas" → searches
["*dental*", "*dentist*", "*orthodont*"] - Multi-keyword search: "Search for med spas, wellness clinics, and aesthetics businesses in California"
- Filter by location: "Show me businesses in Miami and Orlando"
- Filter by rating: "Find contractors with at least 4 stars in Phoenix" (home_improvement only)
- Find fresh leads: "Show me leads updated in the last week" (uses the Last Updated date — the best indicator of lead freshness)
- Exclude terms: "Find new bakeries in NYC but exclude pizza and franchise"
- Full-text search: "Search for organic coffee shops"
- Filter by website schema: "Find businesses with LocalBusiness schema type" (other only)
- Filter by registration date: "Show leads registered in the last 6 months" (other only)
- Preview free: "Preview dental leads in Texas before spending credits" (uses
GET /leads/preview— contacts masked, no credits consumed) - Test filters: "How many leads match my filters?" (preview returns total count, no credit cost)
- Control query credits: "Search but only spend 10 credits" (uses
maxCredits=10on query) - Free re-queries: "Show me only leads I've already exported" (uses
maxCredits=0on query) - Export data: "Export these leads as a CSV"
- Control export credits: "Export but only spend 50 credits max"
- Free re-exports: "Export only previously-exported leads" (uses
maxCredits: 0) - Manage filter presets: "Save this search as 'FL Med Spas'"
- Manage keyword lists: "Create a keyword list for pet industry leads"
- AI auto-refine: "Enable auto-refine on my keyword list" — single-pass AI optimization of keyword lists
- Set up email schedules: "Email me new auto shop leads in Georgia every day"
- Split lead distribution: "Split leads evenly among my sales team"
- Trigger email manually: "Send my scheduled email now"
- AI suggestions: "What categories should I target for my fitness equipment business?"
- AI keywords: "Generate keywords for my business" (wildcard patterns, auto-refine enabled by default)
- Check AI job status: "Check on my keyword generation"
- Manage blacklist: "Exclude example.com from future exports"
- Account info: "What subscription plan am I on?" / "How many credits do I have?"
- Buy credits: "Purchase 500 more credits"
- Auto top-up: "Set up auto top-up so I never run out of credits"
- Check top-up settings: "What are my auto top-up settings?"
- Change plans: "Upgrade to the Growth plan"
- Cancel: "Cancel my subscription"
- Sign up via API: "I want to sign up for a Starter plan" (programmatic purchase, no web signup needed)
The positiveKeywords and negativeKeywords parameters support * wildcard for flexible pattern matching:
"*dental*"— matches "dental clinic", "pediatric dentistry", "dental lab", etc."*auto*repair*"— matches "auto body repair", "automotive repair shop", etc."*med*spa*"— matches "med spa", "medical spa", "medspa services", etc.
Use multiple variations for broader coverage — keywords are matched via OR logic:
["*pet*groom*", "*dog*groom*", "*pet*salon*", "*mobile*groom*"]Keywords without wildcards perform substring matching by default.
URL Space-to-Wildcard: For URL columns, spaces in search terms are automatically replaced with % wildcards. For example, "dental clinic" becomes %dental%clinic% to match URLs like example.com/dental-clinic.
The lastUpdated field is the primary way to identify the freshest, most actionable leads:
- Home Improvement leads: Last Updated means a new phone number was detected
- Other leads: Last Updated means any of the 5 contact/address fields changed: primary phone, secondary phone, primary email, secondary email, or full address
- Also includes newly added records
- Many businesses launch a website before adding contact info, so the Last Updated date captures when that information first becomes available
User: I sell commercial cleaning supplies. Find me newly registered
cleaning businesses in Florida and Georgia updated in the last 7 days.
Claude: [Calls GET /leads with
positiveKeywords=["*clean*service*","*janitorial*","*maid*service*","*pressure*wash*"],
stateInclude=FL,GA, lastUpdatedFrom=rel:7d]
I found 287 cleaning-related businesses in Florida and Georgia updated
in the last week. Here are the first 10 (100 credits used, 400 remaining):
| Company Name | City | State | Phone | Email | Last Updated |
|----------------------------|--------------|-------|--------------|--------------------------|--------------|
| Sparkle Clean Services LLC | Jacksonville | FL | 904-555-0189 | info@sparkleclean.com | 2026-02-19 |
| Fresh Start Janitorial | Atlanta | GA | 678-555-0234 | contact@freshstartjn.com | 2026-02-18 |
| ... | ... | ... | ... | ... | ... |
Would you like me to export all 287 results, narrow the search,
or save this as a filter preset? You can also use maxCredits to
limit how many credits the next search uses.
User: Export those leads but only spend 50 credits max.
Claude: [Calls POST /leads/export with current filters and maxCredits: 50]
Exported 50 new leads (50 credits used, 450 credits remaining).
237 overflow leads stored in your lead reservoir for next export.
Files saved: cleaning_leads_FL_GA.csv
User: Enable auto-refine on my "TX Pet Services" keyword list.
Claude: [Calls GET /keyword-lists to find the list ID, then
POST /ai/auto-refine/enable with listId=42]
Auto-refine is now enabled on your "TX Pet Services" keyword list (ID 42).
The AI will run a single-pass 4-phase optimization: validating existing keywords,
discovering up to 15 new positives and 5 new negatives, then scoring quality.
You can check the status anytime or disable it later.
User: I want to sign up. What plans do you have?
Claude: SMB Sales Boost offers three credit-based plans:
| Plan | Credits/month | Per Credit |
|------|--------------|-----------|
| Starter | 500 | $0.10 |
| Growth | 2,000 | $0.075 |
| Scale | 10,000 | $0.05 |
Plus Platinum ($0.03/credit) and Enterprise ($0.02/credit) tiers.
Would you like me to start a purchase? I can create a checkout session
for you right here — no web signup needed.
- General endpoints: 60 requests per minute
- Export endpoints: 1 per 5 minutes (max 10,000 leads per export)
- AI endpoints: 5 per minute
- Programmatic purchase: 5 per hour per IP
- Claim key: 30 per hour per IP
The skill covers all SMB Sales Boost API endpoints:
| Feature | Endpoints | Operations |
|---|---|---|
| Programmatic Purchase | /purchase, /claim-key |
Start purchase, Claim API key |
| Credits & Subscription | /purchase-credits, /auto-top-up, /subscription/change-plan, /subscription/cancel |
Buy credits, Auto top-up config, Change plan, Cancel |
| User Profile | /me |
Get, Update |
| Lead Search | /leads |
Search with filters, credit-aware (maxCredits, maxResults) |
| Lead Preview | /leads/preview |
Preview leads with masked contacts — no credits consumed |
| Schema Types | /leads/other/schema-types |
List available website schema types |
| Lead Export | /leads/export |
Export to CSV/JSON/XLSX (credit-aware) |
| Filter Presets | /filter-presets |
List, Create, Delete |
| Keyword Lists | /keyword-lists |
List, Create, Update, Delete |
| Email Schedules | /email-schedules |
List, Create, Update, Delete, Trigger |
| Export Formats | /export-formats |
List, Create, Get, Update, Delete, Set Default |
| Export History | /export-history |
List, Download |
| Database Settings | /settings/database, /settings/switch-database |
Get (with canSwitch/daysRemaining), Switch (via smbType field) |
| AI Categories | /ai/suggest-categories |
Suggest categories |
| AI Keywords | /ai/generate-keywords, /ai/keyword-status |
Generate (wildcard patterns), Check status |
| AI Auto-Refine | /ai/auto-refine/enable, /ai/auto-refine/disable, /ai/auto-refine/status |
Enable, Disable, Check status |
| Export Blacklist | /export-blacklist |
List, Add, Remove |
PII in exports: Exported lead files contain business contact information including phone numbers and email addresses. By default, exports are saved to the --output-dir path (defaults to /mnt/user-data/outputs). Ensure this location is secure and do not share exported files in public channels.
Purchase safeguards: This skill can create real Stripe charges via POST /purchase, POST /purchase-credits, and POST /subscription/change-plan. The skill instructions require explicit user confirmation before executing any purchase or plan-change action.
Unauthenticated endpoints: POST /purchase and POST /claim-key do not require an API key (they are used for new-user signup). Because they can initiate Stripe checkout sessions and retrieve API keys without credentials, the skill instructions explicitly prohibit autonomous invocation — the agent must always confirm with the user before calling them.
API key handling: Pass your key via the SMB_SALES_BOOST_API_KEY environment variable or as a CLI argument. Never paste your API key into public chat windows, version control, or shared documents.
This skill addresses two specific agent execution risks identified by security scanning:
1. Shell injection prevention: All API requests go through the included smb_api.py client using Python's requests library. User-provided search terms, locations, and other inputs are passed as structured function arguments — never interpolated into shell command strings. This eliminates the shell injection vector that exists when agents construct curl commands from user input.
2. Path traversal prevention in exports: The /leads/export endpoint returns base64-encoded files with an API-provided fileName field. The script sanitizes all filenames before writing:
- Strips directory components via
os.path.basename()(e.g.,../../etc/passwd→passwd) - Validates file extension against an allowlist (
.csv,.json,.xlsxonly) - Writes only to a designated safe output directory — never to API-specified or user-specified paths
3. API key protection: Keys are passed as CLI arguments and sent only in the Authorization header — never logged, written to files, or included in error output.