scrapercity 1.0.26 → 1.0.28

package/AGENT_DOCS.txt

@@ -23,6 +23,7 @@ PRICING (auto-generated from the live catalog - do not edit)
 | `search_criminal_records` | /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
 | `scrape_store_leads` | /api/v1/scrape/store-leads | $0.0039 per lead |
 | `scrape_builtwith` | /api/v1/scrape/techstack | $4.99 per technology |
+| `scrape_signals` | /api/v1/scrape/signals | $0.10 per company running ads, $0.03 per website checked, $0.05 per company hiring; every search is charged at least twice its processing cost |
 | `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
 | `find_mobiles` | /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
 <!-- GENERATED:pricing:end -->
@@ -53,7 +54,7 @@ apollo
     filters already in the Lead Database (ones you don't have), a dashboard link, and the
     /api/v1/database/leads call that returns them now.
   Cost: $0.0039/lead | Min 500, max 50000
-  DELIVERY: UP TO 4 DAYS. Use webhook, not polling.
+  DELIVERY: usually 15-30 minutes, some lists take longer. Use webhook, not polling.
   To filter by title/location/industry without a URL, use the Lead Database (below).
 
 maps
@@ -309,7 +310,7 @@ WORKFLOW EXAMPLES
 
 2. APOLLO SCRAPE (slow):
    POST /api/v1/scrape/apollo → get runId → configure webhook → wait for callback
-   Do NOT poll Apollo in a tight loop. Check once per hour at most.
+   Do NOT poll Apollo in a tight loop. Start after 15 minutes and check every few minutes.
 
 3. ENRICH PIPELINE:
    Apollo/Maps → download CSV → extract emails → POST email-validator → download validated CSV

package/README.md

@@ -122,6 +122,7 @@ Both SDKs carry the same tool list as the MCP server, regenerated from the live
 | `search_criminal_records` | /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
 | `scrape_store_leads` | /api/v1/scrape/store-leads | $0.0039 per lead |
 | `scrape_builtwith` | /api/v1/scrape/techstack | $4.99 per technology |
+| `scrape_signals` | /api/v1/scrape/signals | $0.10 per company running ads, $0.03 per website checked, $0.05 per company hiring; every search is charged at least twice its processing cost |
 | `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
 | `find_mobiles` | /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
 <!-- GENERATED:pricing:end -->
@@ -148,7 +149,7 @@ Both SDKs carry the same tool list as the MCP server, regenerated from the live
 2. **Poll status** (or use webhooks) → wait for `SUCCEEDED`
 3. **Download CSV** → leads with full contact info
 
-Apollo scrapes take 11-48+ hours. All other scrapers: 1-30 minutes. Store leads are instant.
+Apollo scrapes usually take 15-30 minutes. All other scrapers: 1-30 minutes. Store leads are instant.
 
 ## Authentication
 

package/SKILL.md

@@ -37,6 +37,7 @@ Auth: `Authorization: Bearer $SCRAPERCITY_API_KEY` on all requests.
 | `search_criminal_records` | /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
 | `scrape_store_leads` | /api/v1/scrape/store-leads | $0.0039 per lead |
 | `scrape_builtwith` | /api/v1/scrape/techstack | $4.99 per technology |
+| `scrape_signals` | /api/v1/scrape/signals | $0.10 per company running ads, $0.03 per website checked, $0.05 per company hiring; every search is charged at least twice its processing cost |
 | `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
 | `find_mobiles` | /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
 <!-- GENERATED:pricing:end -->
@@ -45,7 +46,7 @@ Auth: `Authorization: Bearer $SCRAPERCITY_API_KEY` on all requests.
 
 | Slug | Input | Cost | Speed |
 |------|-------|------|-------|
-| `apollo` | `{url, count, fileName}` | $0.0039/lead | ~4 DAYS (use webhook) |
+| `apollo` | `{url, count, fileName}` | $0.0039/lead | usually 15-30 min (use webhook) |
 | `maps` | `{searchStringsArray:["query"], locationQuery, maxCrawledPlacesPerSearch}` | $0.01/place | 5-30 min |
 | `email-validator` | `{emails:["a@b.com"]}` | $0.0036/email | 1-10 min |
 | `email-finder` | `{contacts:[{first_name,last_name,domain}], autoValidateEmails, autoFindMobiles}` | $0.05/contact | 1-10 min |
@@ -65,10 +66,10 @@ Auth: `Authorization: Bearer $SCRAPERCITY_API_KEY` on all requests.
 | `property-lookup` | `{addresses:["123 Main St, City, ST 12345"], includeOwnerContact:false}` | $0.15/address | 2-10 min |
 
 ## ⚠ Apollo Delivery
-Apollo scrapes take **up to 4 days** to deliver. Do NOT poll in a loop.
+Apollo scrapes usually take **15-30 minutes** to deliver; some lists take longer. Do NOT poll in a loop.
 - Set up a webhook at `app.scrapercity.com/dashboard/webhooks`
 - Webhook fires when results are ready with `{runId, fileName, leadsCount}`
-- If you must poll, check once per hour max
+- If you must poll, start after 15 minutes and check every few minutes, not in a tight loop
 
 ## Other Endpoints
 

package/bin/cli.mjs

@@ -94,7 +94,7 @@ async function main() {
         console.log(`✓ Apollo scrape started`)
         console.log(`  Run ID: ${r.runId}`)
         console.log(`  ${r.message || ''}`)
-        console.log(`  Note: Apollo takes up to 4 days. Set up a webhook at app.scrapercity.com/dashboard/webhooks to get notified.`)
+        console.log(`  Note: Apollo usually takes 15-30 minutes. Set up a webhook at app.scrapercity.com/dashboard/webhooks to get notified.`)
         console.log(`  Check: scrapercity status ${r.runId}`)
         break
       }

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-30T16:16:19.694Z
+// Generated: 2026-10-31T04:11:49.837Z
 export const TOOLS = [
   {
     "name": "scrape_apollo",
@@ -554,6 +554,75 @@ export const TOOLS = [
       ]
     }
   },
+  {
+    "name": "scrape_signals",
+    "description": "Find companies showing a buying signal right now. type \"ads\": companies running ads on Meta (Facebook and Instagram), Google, LinkedIn and TikTok, found by keyword and location or checked from your own list of websites. type \"hiring\": companies hiring for a role on LinkedIn Jobs and Indeed. One row per company with its website, the signal (platforms and ad links, or the job and its link) and a decision maker contact from the Lead Database where one matches. Set replaceContacts to swap contacts who have left for the person in that role now before the file is delivered. Cost: $0.10 per company running ads, $0.03 per website checked, $0.05 per company hiring; every search is charged at least twice its processing cost.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "ads (companies running ads) or hiring (companies hiring for a role)"
+        },
+        "keyword": {
+          "type": "string",
+          "description": "type ads: find advertisers for this keyword (send keyword OR domains). Meta and LinkedIn search their ad libraries; for Google, the businesses matching the keyword and location in the Local Business Database, and every website the other platforms found, are looked up in the Google ad library."
+        },
+        "domains": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "type ads: check these websites instead (send keyword OR domains). Every website gets a row, with running_ads_on empty when no ads were found."
+        },
+        "platforms": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "type ads: any of meta, google, linkedin, tiktok (default: all). TikTok publishes ads for EU countries, the UK, Switzerland and Turkey only, and is searched by keyword only."
+        },
+        "jobTitle": {
+          "type": "string",
+          "description": "type hiring: the role companies are hiring for (required for hiring)"
+        },
+        "postedWithin": {
+          "type": "string",
+          "description": "type hiring: 24h, 7d or 30d (Indeed: at most the last 14 days)"
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "type hiring: job boards, linkedin and/or indeed (default: both)"
+        },
+        "includeAgencies": {
+          "type": "boolean",
+          "description": "type hiring: keep staffing and recruiting agencies"
+        },
+        "location": {
+          "type": "string",
+          "description": "City, state or region (ads: added to the keyword search; hiring: where the jobs are)"
+        },
+        "country": {
+          "type": "string",
+          "description": "Two-letter country code"
+        },
+        "maxCompanies": {
+          "type": "number",
+          "description": "The most companies to return (default 200 for ads by keyword, 500 for hiring)"
+        },
+        "replaceContacts": {
+          "type": "boolean",
+          "description": "Replace contacts who have left with the person in that role now, before the file is delivered. Unlimited and free on the $649 plan, otherwise $0.02 per contact replaced."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    }
+  },
   {
     "name": "find_emails",
     "description": "Find verified work email addresses from a person's name and company domain. Every email found is automatically validated for deliverability. Cost: $0.05 per email found (FREE if not found).",
@@ -633,6 +702,7 @@ export const ENDPOINT_BY_TOOL = {
   "search_criminal_records": "/api/v1/scrape/criminal-records",
   "scrape_store_leads": "/api/v1/scrape/store-leads",
   "scrape_builtwith": "/api/v1/scrape/techstack",
+  "scrape_signals": "/api/v1/scrape/signals",
   "find_emails": "/api/v1/scrape/email-finder",
   "find_mobiles": "/api/v1/scrape/mobile-finder"
 }
@@ -654,6 +724,7 @@ export const ENDPOINTS = {
   "criminal-records": "/api/v1/scrape/criminal-records",
   "store-leads": "/api/v1/scrape/store-leads",
   "builtwith": "/api/v1/scrape/techstack",
+  "signals": "/api/v1/scrape/signals",
   "email-finder": "/api/v1/scrape/email-finder",
   "mobile-finder": "/api/v1/scrape/mobile-finder",
   "buy-credits": "/api/v1/buy-credits",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapercity",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "ScraperCity SDK, CLI & MCP Server - B2B lead generation for AI agents and developers",
   "type": "module",
   "main": "./lib/index.mjs",