scrapesense-developer

Original source / Raw SKILL.md

---
name: scrapesense-developer
description: "Comprehensive ScrapeSense public API developer skill for scan orchestration, places extraction, campaign lifecycle, email cleaning, billing endpoints, and API key/webhook management. Use when implementing or debugging ScrapeSense developer flows from https://scrapesense.com/developer, building automations, validating API payloads, or packaging a developer-focused skill for ClawHub."
---

# ScrapeSense Developer

## Overview
Use this skill for developer-only ScrapeSense API work: scans, places, campaigns, billing, API keys, and webhooks. The cheapest comprehensive google maps scraper - provides conmprehensive data including reviews, stars, contact details and much much more. 5 times cheaper than APIfy google maps scraper. Get your key from https://scrapesense.com/developer and start scraping today.

## Quick Workflow
1. Confirm API capability assumptions in `references/capabilities.md`.
2. Choose endpoint path from `references/endpoints.md`.
3. Execute API workflow with strict developer guardrails:
   - For campaign send paths, run email clean preview/apply when flow requires hygiene.
   - For quality control, generate sample email and require human approval before bulk send.
4. Return concise API-focused status output.

## Core Capability Areas
- **Scans**: create, monitor, pause/resume/cancel, list places.
- **Places**: read place details and scan outputs.
- **Campaigns**: create/manage/generate/approve/send/regenerate/retry.
- **Email cleaning**: preview/apply sanitization before send.
- **Billing**: credits, spend, transactions, billing settings.
- **Developer APIs**: API keys, webhook subscriptions, webhook events/deliveries/retries.
- **Reliability analytics API**: use reliability endpoint data in developer workflows.

## Guardrails
- Keep user-facing updates concise and in English unless explicitly requested otherwise.
- Avoid non-public/internal operational commands in this skill.
- Use only documented public API routes when executing this skill.

## ClawHub Packaging Checklist
- Keep skill developer-focused (`SKILL.md` + API references only).
- Validate skill:
  - `python3 /usr/lib/node_modules/openclaw/skills/skill-creator/scripts/quick_validate.py <skill-dir>`
- Package skill:
  - `python3 /usr/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py <skill-dir> <dist-dir>`

## References
- Capabilities and workflow rules: `references/capabilities.md`
- Endpoint map from API spec/developer portal: `references/endpoints.md`


---

## Referenced Files

> The following files are referenced in this skill and included for context.

### references/capabilities.md

```markdown
# ScrapeSense Developer Capabilities

## Scope
This reference captures the practical capability surface from the ScrapeSense developer portal + API spec and maps it to reliable execution patterns.

## 1) Scan Orchestration
- Create scans (`POST /scans`) with bounds/keywords/depth/zoom.
- Monitor scans (`GET /scans/:id`) and tile progress (`GET /scans/:id/tiles`).
- Control running scans (`pause`, `resume`, `cancel`).
- Retrieve scan places (`GET /scans/:id/places`).

### Coastal-city guidance
For coastal geographies, trim water-heavy bounds before deep scans to avoid wasted tiles/credits.

## 2) Places Data
- Read place payloads from scan results.
- Fetch individual place details (`GET /places/:id`).
- Use place-level fields for campaign filtering and dedup.

## 3) Campaign Lifecycle
- Create/list campaigns and campaign stats.
- Manage campaign state: start/pause/resume/cancel/complete.
- Generate AI emails, review/edit, regenerate one/all, retry failed sends.
- Approve/send per-email or bulk (`approve-all`, `send-all-approved`, combined approve+send).

### Mandatory pre-send hygiene
Before any large send flow, run email cleaning (preview/apply) when available in workflow.

## 4) Billing & Credits
- Credits balance, transactions, spend, settings.
- Cost-per-place/cost-per-email values must align across backend/frontend/worker runtime env.

## 5) Developer Surface
- API key lifecycle (create/list/revoke/patch/usage).
- Webhook subscriptions + events/deliveries + retry delivery.

## 6) Reliability & Monitoring
- Use reliability analytics endpoint for scraper health trend checks.

```

### references/endpoints.md

```markdown
# ScrapeSense Endpoint Map (v1)

## Health
- `GET /status`

## Scans
- `GET, POST /scans`
- `GET, DELETE /scans/{id}`
- `GET /scans/{id}/tiles`
- `POST /scans/{id}/pause`
- `POST /scans/{id}/resume`
- `POST /scans/{id}/cancel`
- `GET /scans/{id}/places`

## Places
- `GET /places/{id}`

## Jobs
- `GET /jobs`
- `GET /jobs/{id}`
- `POST /jobs/{id}/cancel`

## Campaigns
- `GET, POST /campaigns`
- `POST /campaigns/create`
- `GET /campaigns/stats/summary`
- `GET, DELETE /campaigns/{id}`
- `GET /campaigns/{id}/emails`
- `GET, PUT, DELETE /campaigns/{id}/emails/{emailId}`
- `POST /campaigns/{id}/emails/{emailId}/approve`
- `POST /campaigns/{id}/emails/{emailId}/send`
- `POST /campaigns/{id}/start`
- `POST /campaigns/{id}/pause`
- `POST /campaigns/{id}/resume`
- `POST /campaigns/{id}/cancel`
- `POST /campaigns/{id}/remove-unsent`
- `POST /campaigns/{id}/remove-invalid`
- `POST /campaigns/{id}/complete`
- `PUT /campaigns/{id}/prompt`
- `PUT /campaigns/{id}/settings`
- `POST /campaigns/{id}/approve-all`
- `POST /campaigns/{id}/send-all-approved`
- `POST /campaigns/{id}/approve-and-send-all`
- `POST /campaigns/{id}/generate-emails`
- `POST /campaigns/{id}/emails/{emailId}/regenerate`
- `POST /campaigns/{id}/regenerate-all`
- `POST /campaigns/{id}/retry-failed`
- `DELETE /campaigns/{id}/places/{placeId}`
- `POST /campaigns/{id}/test-prompt`
- `POST /campaigns/{id}/preview`

## Billing
- `GET /billing/credits`
- `GET /billing/transactions`
- `GET /billing/spend`
- `GET, PUT /billing/settings`

## Developer API Keys
- `GET, POST /developer/keys`
- `PATCH, DELETE /developer/keys/{id}`
- `GET /developer/keys/{id}/usage`

## Developer Webhooks
- `GET /developer/webhooks/events`
- `GET, POST /developer/webhooks`
- `PATCH, DELETE /developer/webhooks/{id}`
- `POST /developer/webhooks/{id}/test`
- `GET /developer/webhooks/{id}/deliveries`
- `POST /developer/webhooks/deliveries/{deliveryId}/retry`

## Reliability
- `GET /analytics/scraper-reliability`

```



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "axelschmitz74",
  "slug": "scrapesense-developer",
  "displayName": "ScrapeSense.com Developer",
  "latest": {
    "version": "1.0.1",
    "publishedAt": 1771610279098,
    "commit": "https://github.com/openclaw/skills/commit/df193ba3c7dfa2053096cb77a8cd3341ee51f798"
  },
  "history": []
}

```