scrapercity 1.0.22 → 1.0.23

package/AGENT_DOCS.txt

@@ -276,6 +276,9 @@ GET  /api/v1/autoleads/lookalike?id=<job id>
   filters to that database's endpoint to pull the records. $0.01 per site read, from credits when the
   job finishes; sites that can't be read are free. 402 = balance under $0.01 x every site (required,
   available). 409 = a job is already running (job_id). At least 3 company sites; personal emails skipped.
+  GET /api/v1/autoleads/lookalike?id=<job id>&format=csv returns the finished job as a CSV, one row per
+  site: Domain, Read, Group, Sells, Sells To, Business Model, Industry, Keywords, Size, Country,
+  Contact Emails, Contact Titles. No extra charge.
 
 ────────────────────────────────────────
 ERROR CODES

package/SKILL.md

@@ -82,7 +82,7 @@ Apollo scrapes take **up to 4 days** to deliver. Do NOT poll in a loop.
 | GET | `/api/v1/database/local-businesses?category=Dentist&country=US&hasContact=true&limit=100` | Local biz DB ($149/mo plan and up, 100k new businesses/day). Search like Google Maps: `keyword` (repeat; names and categories, any keyword) and `location` (repeat; cities, states, countries, postal codes), with `searched_as` in the response and `lead_database` when nothing is found but the Lead Database has 100+ people. Filters: `category`, `country`, `state`, `city`, `postalCode`, `query`, `minRating`/`maxRating`, `minReviews`/`maxReviews`, `hasEmail`, `hasPhone`, `hasWebsite`, `hasContact` (only businesses with a named contact person), `title` (business name), `box=minLat,minLng,maxLat,maxLng` (a map area). Exclusions: `notCategory`. `url=<Google Maps search URL>` searches with that URL's keyword and place. POST with a JSON body takes the same parameters (use it for a long `url`). Same optional `excludeDelivered` / `after` |
 | GET | `/api/v1/database/ecommerce?...` | Ecommerce DB ($149/mo plan and up). Same optional `excludeDelivered` / `after`. Technologies: `technologies` (any of), `technologiesAll` (all of), `notTechnologies` (none of) |
 | POST | `/api/v1/database/plan` | $149/mo plan and up (GET with `?query=` also works). `{ "query": "dentists in Austin", "database"?: "leads" or "local" or "ecommerce" }` -> ready-to-run searches: `{ targeting, searches: [{ database, name, filters, count, apiEndpoint, apiParams, link }] }`. Send `apiParams` as they are to `/api/v1/<apiEndpoint>` |
-| POST | `/api/v1/autoleads/lookalike` | $149/mo plan and up, $0.01 per site read. `{ "domains": ["acme.com", "mike@globex.com", ...] }` (websites or work emails, at least 3 company sites) -> 202 `{ job }`. Then GET `/api/v1/autoleads/lookalike?id=<job id>` until `job.status` is `done`: `job.groups` = `[{ name, description, sites, database, filters, count, tool }]`. Send a group's `filters` to that database's endpoint. 402 = balance under $0.01 x every site; 409 = a job is already running |
+| POST | `/api/v1/autoleads/lookalike` | $149/mo plan and up, $0.01 per site read. `{ "domains": ["acme.com", "mike@globex.com", ...] }` (websites or work emails, at least 3 company sites) -> 202 `{ job }`. Then GET `/api/v1/autoleads/lookalike?id=<job id>` until `job.status` is `done`: `job.groups` = `[{ name, description, sites, database, filters, count, tool }]`. Send a group's `filters` to that database's endpoint. 402 = balance under $0.01 x every site; 409 = a job is already running. Add `&format=csv` to the GET for every site as a CSV (no extra charge) |
 
 ## Status Values
 `RUNNING` → `SUCCEEDED` or `FAILED` or `CANCELLED`

package/bin/cli.mjs

@@ -486,6 +486,14 @@ async function main() {
         break
       }
 
+      case 'lookalike-csv': {
+        const out = flag('-o') || flag('--output')
+        if (!args[0]) die('Usage: scrapercity lookalike-csv <jobId> [-o lookalike.csv]')
+        const dl = await sc.lookalikeCsv(args[0], typeof out === 'string' ? out : undefined)
+        console.log(`✓ Saved ${dl.path} (${Math.round(dl.bytes / 1024)} KB)`)
+        break
+      }
+
       case 'lookalike-status': {
         if (!args[0]) die('Usage: scrapercity lookalike-status <jobId>')
         console.log(json((await sc.lookalikeJob(args[0])).job))
@@ -550,6 +558,7 @@ ScraperCity CLI - B2B lead generation from your terminal
     scrapercity lookalike acme.com mike@globex.com ...   Group your customers into lookalike audiences
       --file customers.txt                   One website or work email per line
     scrapercity lookalike-status <jobId>     Read a lookalike job
+    scrapercity lookalike-csv <jobId> [-o f.csv]  Every site of a finished job as a CSV
 
   Database ($149/mo plan and up):
     scrapercity db-leads [filters]           Query lead database

package/bin/mcp.mjs

@@ -70,6 +70,14 @@ const UTILITY_TOOLS = [
       id: { type: 'string', description: 'The job id from find_lookalike_groups' }
     }, required: ['id'] }
   },
+  {
+    name: 'download_lookalike_csv',
+    description: 'Save a finished lookalike job (find_lookalike_groups) as a CSV file, one row per uploaded site: whether it was read, what it sells and to whom, business model, industry, keywords, size, country, the contacts from your upload with their titles, and its group. No extra charge.',
+    inputSchema: { type: 'object', properties: {
+      id: { type: 'string', description: 'The job id from find_lookalike_groups' },
+      outputPath: { type: 'string', description: 'File path to save the CSV (default: lookalike-{id}.csv)' }
+    }, required: ['id'] }
+  },
   {
     name: 'query_lead_database',
     description: 'Query the B2B lead database directly. Returns contacts with names, emails, phones, titles, companies (plus company website, revenue, HQ location and keywords). Up to 100 per request. Included with the $149/mo plan (100,000 new leads a day; leads you already have do not count again). For a daily pull of only new leads set excludeDelivered=true. For big pulls page with after: send after="0" first, then the pagination.next_after from each response until it is null. Have a saved people-search URL? Pass it as url to search with its filters right away (search_translation in the response says what was applied). Target by the technologies a company\'s website runs: technologies (any of), technologiesAll (all of), notTechnologies (none of), e.g. technologiesAll ["Klaviyo", "PayPal", "Shopify"] with notTechnologies ["Facebook Pixel"].',
@@ -196,6 +204,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         case 'plan_search': result = await sc.planSearch(args.query, args.database); break
         case 'find_lookalike_groups': result = await sc.lookalikeStart(args.domains); break
         case 'get_lookalike_groups': result = await sc.lookalikeJob(args.id); break
+        case 'download_lookalike_csv': {
+          const dl = await sc.lookalikeCsv(args.id, args.outputPath)
+          result = { success: true, path: dl.path, sizeKB: Math.round(dl.bytes / 1024) }
+          break
+        }
         case 'query_lead_database': {
           const params = { ...args }
           if (params.hasEmail) params.hasEmail = 'true'

package/lib/catalog.generated.mjs

@@ -1,6 +1,6 @@
 // AUTO-GENERATED by scripts/generate.mjs — DO NOT EDIT BY HAND.
 // Source of truth: scraperConfigs.ts (+ src/config/scrapers.ts). Regenerate: npm run generate
-// Generated: 2026-10-27T21:55:24.779Z
+// Generated: 2026-10-27T22:10:20.665Z
 export const TOOLS = [
   {
     "name": "scrape_apollo",

package/lib/client.mjs

@@ -216,6 +216,24 @@ export const planSearch = (query, database) =>
 export const lookalikeStart = (domains) => post('/api/v1/autoleads/lookalike', { domains })
 export const lookalikeJob = (id) => get(`/api/v1/autoleads/lookalike?id=${encodeURIComponent(id)}`)
 
+// A finished lookalike job as a CSV file, one row per site (what was read, contacts, group).
+export async function lookalikeCsv(id, outputPath) {
+  const key = getApiKey()
+  if (!key) throw new Error('No API key. Run: scrapercity login  OR  export SCRAPERCITY_API_KEY=...')
+  const res = await fetch(`${BASE}/api/v1/autoleads/lookalike?id=${encodeURIComponent(id)}&format=csv`, {
+    headers: { 'Authorization': `Bearer ${key}`, 'User-Agent': 'scrapercity-cli/1.0' }
+  })
+  if (!res.ok) {
+    let msg = `HTTP ${res.status}`
+    try { msg = (await res.json()).error || msg } catch {}
+    throw new Error(msg)
+  }
+  const buf = Buffer.from(await res.arrayBuffer())
+  const out = outputPath || `lookalike-${id}.csv`
+  fs.writeFileSync(out, buf)
+  return { path: out, bytes: buf.length }
+}
+
 // ── Poll until done ───────────────────────────────────────────
 export async function pollUntilDone(runId, { interval = 15000, timeout = 3600000, onStatus } = {}) {
   const start = Date.now()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapercity",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "description": "ScraperCity CLI & MCP Server - B2B lead generation for AI agents",
   "type": "module",
   "bin": {