scrapercity 1.0.23 → 1.0.25

package/AGENT_DOCS.txt

@@ -20,13 +20,21 @@ PRICING (auto-generated from the live catalog - do not edit)
 | `scrape_yelp` | /api/v1/scrape/yelp-scraper | $0.0099 per result |
 | `scrape_zillow_agents` | /api/v1/scrape/zillow-agents | $0.029 per agent |
 | `scrape_property_lookup` | /api/v1/scrape/property-lookup | $0.15 per property (+$0.10 for owner contact) |
-| `search_criminal_records` | /api/v1/scrape/criminal-records | .00 per search (only charged if records found) |
+| `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 |
 | `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 -->
 
+SDKS: the same tools as the MCP server, regenerated from these docs on every release.
+  JavaScript: npm install scrapercity
+    import { configure, callTool, TOOLS, openaiTools, anthropicTools } from 'scrapercity'
+  Python:     pip install scrapercity    (extras: [langchain], [openai])
+    from scrapercity import ScraperCity, langchain_tools
+    ScraperCity().call_tool("query_lead_database", {"title": "CEO", "limit": 10})
+  Guide: https://scrapercity.com/sdk
+
 BASE: https://app.scrapercity.com
 AUTH: Authorization: Bearer <api_key>
 ALL RESPONSES: JSON
@@ -214,8 +222,10 @@ GET /api/v1/database/leads?title=CTO&country=United States&hasEmail=true&page=1&
   100k/day limit; fetching a lead you already have again is free.
   Returns: { data: [...leads], pagination: { page, limit, total, totalPages, has_more, next_after }, rate_limit,
              search_translation? }
-  Lead fields include company_industry, company_size, employees_count, company_website,
-  company_annual_revenue, company_city, company_state, company_country, keywords.
+  Lead fields include twitter_url, facebook_url, company_industry, company_size,
+  employees_count, company_website, company_phone, company_annual_revenue,
+  company_total_funding, company_founded_year, company_city, company_state,
+  company_country, keywords.
   409 with filters_not_applied_yet: the company filters listed can't be used yet (company
   data still being prepared right after launch). Nothing is returned or counted; retry later
   or drop those filters.

package/README.md

@@ -1,6 +1,6 @@
 # ScraperCity - B2B Lead Generation for AI Agents
 
-Pull leads, validate emails, find mobile numbers, and scrape business data - all from your AI agent, CLI, or code.
+Pull leads, validate emails, find mobile numbers, and scrape business data - all from your AI agent, CLI, or code. One package: the MCP server, the CLI and the JavaScript SDK. The Python SDK is `pip install scrapercity`.
 
 ScraperCity gives AI agents access to 15+ B2B data tools: Apollo scraping, Google Maps extraction, email finding/validation, mobile number lookup, skip tracing, ecommerce store data, criminal records, and more.
 
@@ -66,6 +66,41 @@ curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
   -H "Authorization: Bearer $SCRAPERCITY_API_KEY"
 ```
 
+### Option 5: JavaScript SDK
+
+```bash
+npm install scrapercity
+```
+
+```js
+import { configure, wallet, dbLeads, callTool, TOOLS, openaiTools, anthropicTools } from 'scrapercity'
+
+configure({ apiKey: process.env.SCRAPERCITY_API_KEY })
+await wallet()
+await dbLeads({ title: 'CEO', country: ['United States'], hasEmail: 'true', limit: 25 })
+
+// Every tool the MCP server offers, by name, with the same arguments
+await callTool('plan_search', { query: 'dentists in Austin, Texas' })
+
+// Hand the whole tool list to OpenAI or Anthropic tool calling
+const tools = openaiTools()        // or anthropicTools()
+```
+
+### Option 6: Python SDK
+
+```bash
+pip install scrapercity                 # add [langchain] or [openai] for agent tools
+```
+
+```python
+from scrapercity import ScraperCity, langchain_tools
+sc = ScraperCity()                      # reads SCRAPERCITY_API_KEY
+sc.call_tool("query_lead_database", {"title": "CEO", "limit": 10})
+tools = langchain_tools()               # LangChain / LangGraph
+```
+
+Both SDKs carry the same tool list as the MCP server, regenerated from the live API docs on every release. Guide: [scrapercity.com/sdk](https://scrapercity.com/sdk). Python package: [pypi.org/project/scrapercity](https://pypi.org/project/scrapercity/).
+
 ## Pricing (auto-generated from the live catalog — do not edit)
 
 <!-- GENERATED:pricing:start -->
@@ -84,7 +119,7 @@ curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
 | `scrape_yelp` | /api/v1/scrape/yelp-scraper | $0.0099 per result |
 | `scrape_zillow_agents` | /api/v1/scrape/zillow-agents | $0.029 per agent |
 | `scrape_property_lookup` | /api/v1/scrape/property-lookup | $0.15 per property (+$0.10 for owner contact) |
-| `search_criminal_records` | /api/v1/scrape/criminal-records | .00 per search (only charged if records found) |
+| `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 |
 | `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
@@ -146,6 +181,8 @@ Buy additional credits anytime. [scrapercity.com/pricing](https://scrapercity.co
 
 - [Agent Docs](https://scrapercity.com/agents) - setup guide
 - [API Reference](https://scrapercity.com/api-docs) - full documentation
+- [SDK guide](https://scrapercity.com/sdk) - JavaScript and Python SDKs
+- [Python SDK on PyPI](https://pypi.org/project/scrapercity/) - `pip install scrapercity`
 - [Skill File](https://scrapercity.com/agents/SKILL.md) - for Claude Code
 - [MCP Server Listing](https://scrapercity.com/agents) - configuration
 

package/SKILL.md

@@ -5,6 +5,7 @@
 export SCRAPERCITY_API_KEY="your_key"   # get from app.scrapercity.com/dashboard/api-docs
 npx scrapercity wallet                   # verify balance
 ```
+Writing code instead? Use an SDK with the same tools as the MCP server: `npm install scrapercity` (`import { callTool } from 'scrapercity'`) or `pip install scrapercity` (`ScraperCity().call_tool(...)`, plus LangChain and OpenAI Agents tools). Guide: https://scrapercity.com/sdk
 
 ## Core Pattern
 Every scraper follows: **start → poll → download**
@@ -33,7 +34,7 @@ Auth: `Authorization: Bearer $SCRAPERCITY_API_KEY` on all requests.
 | `scrape_yelp` | /api/v1/scrape/yelp-scraper | $0.0099 per result |
 | `scrape_zillow_agents` | /api/v1/scrape/zillow-agents | $0.029 per agent |
 | `scrape_property_lookup` | /api/v1/scrape/property-lookup | $0.15 per property (+$0.10 for owner contact) |
-| `search_criminal_records` | /api/v1/scrape/criminal-records | .00 per search (only charged if records found) |
+| `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 |
 | `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |

package/bin/mcp.mjs

@@ -2,249 +2,26 @@
 // bin/mcp.mjs - ScraperCity MCP Server (stdio transport)
 // Connect from Claude Code / Cursor / any MCP client.
 //
-// The SCRAPER tools are generated from scraperConfigs.ts (see lib/catalog.generated.mjs)
-// and dispatched generically: the tool's args are POSTed straight to its /api/v1/scrape
-// endpoint. Nothing per-scraper is hand-written here — add a scraper to the config and it
-// shows up automatically on the next publish. Only the non-scraper utility/DB tools below
-// are hand-defined.
+// The tool list and the dispatcher live in lib/tools.mjs, shared with the JavaScript SDK
+// (lib/index.mjs); scripts/generate.mjs writes the same list into the Python SDK. Scraper tools
+// are generated from scraperConfigs.ts and POSTed straight to their /api/v1/scrape endpoint;
+// the hand-written tools (account, runs, databases, lookalikes) are in lib/utilityTools.mjs.
 import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js'
-import * as sc from '../lib/client.mjs'
-import { TOOLS as SCRAPER_TOOLS, ENDPOINT_BY_TOOL } from '../lib/catalog.generated.mjs'
+import { TOOLS, callTool } from '../lib/tools.mjs'
 
 const server = new Server({ name: 'scrapercity', version: '1.0.0' }, { capabilities: { tools: {} } })
 
-// ── Non-scraper tools (utility + database), hand-defined ──────
-const UTILITY_TOOLS = [
-  {
-    name: 'check_wallet',
-    description: 'Check account balance, plan, and billing info. Call this FIRST to verify credits before running any scrape.',
-    inputSchema: { type: 'object', properties: {} }
-  },
-  {
-    name: 'list_runs',
-    description: 'List recent scraper runs with status, lead counts, and costs.',
-    inputSchema: { type: 'object', properties: {
-      hours: { type: 'number', description: 'How many hours back to look (default 24, max 168)', default: 24 },
-      limit: { type: 'number', description: 'Max runs to return (default 20, max 100)', default: 20 }
-    } }
-  },
-  {
-    name: 'check_run_status',
-    description: 'Check the status of a scraper run. Returns status (RUNNING/SUCCEEDED/FAILED/CANCELLED), lead count, and download URL when complete.',
-    inputSchema: { type: 'object', properties: { runId: { type: 'string', description: 'The run ID returned when starting a scrape' } }, required: ['runId'] }
-  },
-  {
-    name: 'download_results',
-    description: 'Download the CSV results of a completed scraper run. Only works when status is SUCCEEDED.',
-    inputSchema: { type: 'object', properties: {
-      runId: { type: 'string', description: 'The run ID to download results for' },
-      outputPath: { type: 'string', description: 'File path to save CSV (default: {runId}.csv)' }
-    }, required: ['runId'] }
-  },
-  {
-    name: 'cancel_run',
-    description: 'Cancel a running scraper job.',
-    inputSchema: { type: 'object', properties: { runId: { type: 'string', description: 'The run ID to cancel' } }, required: ['runId'] }
-  },
-  {
-    name: 'plan_search',
-    description: 'Turn a plain-English request into ready-to-run database searches. Describe who you want ("dentists in Austin", "websites that use Shopify", "CEOs of SaaS companies in Texas") or what you sell ("I sell life insurance"). Returns a few searches, each with its database, filters set to values that database really has, how many records match (leaving out what this account already has), a dashboard link, and apiParams to pass as they are to the matching query tool: query_lead_database for database/leads, query_local_business_database for database/local-businesses, query_ecommerce_database for database/ecommerce. Included with the $149/mo plan, like the database tools. Use it before a database query whenever you are not sure of the exact filter values.',
-    inputSchema: { type: 'object', properties: {
-      query: { type: 'string', description: 'What you are looking for or what you sell, in plain English' },
-      database: { type: 'string', enum: ['leads', 'local', 'ecommerce'], description: 'Optional: plan in this database only (leads = people at companies, local = local businesses, ecommerce = online stores). Leave it out to let the planner pick the databases that fit.' }
-    }, required: ['query'] }
-  },
-  {
-    name: 'find_lookalike_groups',
-    description: 'Group your customers into lookalike audiences. Send their websites or work emails (mike@acme.com reads acme.com and looks up Mike\'s title). Starts a background job and returns it with its id; then call get_lookalike_groups until status is done. Each group comes with ready-to-run database filters, a match count and the best tool to reach businesses like them. $0.01 per site read, from credits; your balance must cover $0.01 x every site. One job at a time. $149/mo plan and up.',
-    inputSchema: { type: 'object', properties: {
-      domains: { type: 'array', items: { type: 'string' }, description: 'Your customers\' websites, URLs or work emails. At least 3 company sites.' }
-    }, required: ['domains'] }
-  },
-  {
-    name: 'get_lookalike_groups',
-    description: 'Read a lookalike job started with find_lookalike_groups: status (running, done, failed), percent, and when done the groups. Each group has name, description, sites (your customers in it), database (leads, local, ecommerce), filters, count and tool. Pass its filters to query_lead_database, query_local_business_database or query_ecommerce_database to pull the records.',
-    inputSchema: { type: 'object', properties: {
-      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"].',
-    inputSchema: { type: 'object', properties: {
-      url: { type: 'string', description: 'A people-search URL (the address of a people search with its filters). Its filters become the search; any other filter you pass overrides the matching one.' },
-      title: { type: 'string', description: 'Job title filter, comma separated for several (partial match, e.g. "CEO, Founder")' },
-      industry: { type: 'array', items: { type: 'string' }, description: 'Company industries (any match)' },
-      country: { type: 'array', items: { type: 'string' }, description: 'Person countries, full names like "United States" (US, USA, UK, UAE also work)' },
-      state: { type: 'array', items: { type: 'string' }, description: 'Person states' },
-      city: { type: 'string', description: 'Person city, comma separated for several' },
-      companyName: { type: 'string', description: 'Company name' },
-      companyDomain: { type: 'string', description: 'Company domain(s), comma separated' },
-      seniority: { type: 'array', items: { type: 'string' }, description: 'e.g. ["vp", "director", "c_suite"]' },
-      department: { type: 'array', items: { type: 'string' }, description: 'e.g. ["sales", "engineering"]' },
-      minEmployees: { type: 'number', description: 'Minimum company employee count' },
-      maxEmployees: { type: 'number', description: 'Maximum company employee count' },
-      keywords: { type: 'array', items: { type: 'string' }, description: 'Company keywords/tags, any match (e.g. ["saas", "fintech"])' },
-      revenueMin: { type: 'number', description: 'Minimum company annual revenue, USD' },
-      revenueMax: { type: 'number', description: 'Maximum company annual revenue, USD' },
-      companyCountry: { type: 'array', items: { type: 'string' }, description: 'Company HQ countries (not where the person is)' },
-      companyState: { type: 'array', items: { type: 'string' }, description: 'Company HQ states' },
-      companyCity: { type: 'string', description: 'Company HQ city' },
-      notTitle: { type: 'string', description: 'Exclude titles containing any of these (comma separated)' },
-      notKeywords: { type: 'array', items: { type: 'string' }, description: 'Exclude companies with any of these keywords' },
-      notIndustry: { type: 'array', items: { type: 'string' }, description: 'Exclude these industries' },
-      technologies: { type: 'array', items: { type: 'string' }, description: 'Companies whose website runs ANY of these technologies, e.g. ["HubSpot"]' },
-      technologiesAll: { type: 'array', items: { type: 'string' }, description: 'Companies whose website runs ALL of these technologies, e.g. ["Klaviyo", "PayPal"] (keep it to 1-3)' },
-      notTechnologies: { type: 'array', items: { type: 'string' }, description: 'Leave out companies whose website runs any of these technologies, e.g. ["Facebook Pixel"]' },
-      socialUrl: { type: 'string', description: 'Match a social profile URL' },
-      hasEmail: { type: 'boolean', description: 'Only contacts with email' },
-      hasPhone: { type: 'boolean', description: 'Only contacts with phone' },
-      page: { type: 'number', description: 'Page number (default 1)', default: 1 },
-      limit: { type: 'number', description: 'Results per page (max 100)', default: 50 },
-      excludeDelivered: { type: 'boolean', description: 'Skip leads this account already has (from the API or unlocked in the dashboard). With this on, keep page at 1 or use after.' },
-      after: { type: 'string', description: 'Cursor paging: return leads after this lead id. Use "0" to start, then the pagination.next_after from each response.' }
-    } }
-  },
-  {
-    name: 'query_local_business_database',
-    description: 'Query the local business database directly. Returns businesses with phone numbers, emails, websites, addresses and ratings, many with a named contact person. Up to 100 per request. Included with the $149/mo plan (100,000 new businesses a day; businesses you already have do not count again). Set hasContact=true for only businesses with a named contact person. For a daily pull of only new businesses 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. Search the way you would on Google Maps: keyword (what the businesses do or are called, e.g. ["thai restaurant"]) and location (cities, states, countries or postal codes, e.g. ["Houston TX", "Austin TX"]); searched_as in the response says how each was read. A search that finds nothing also returns lead_database: the same search in the Lead Database when it has 100+ people. Have a Google Maps search URL? Pass it as url to search with its keyword and place right away (search_translation in the response says what was applied).',
-    inputSchema: { type: 'object', properties: {
-      keyword: { type: 'array', items: { type: 'string' }, description: 'What the businesses do or are called, as typed on Google Maps, e.g. ["thai restaurant", "sushi"]. Matches business names and categories; any keyword. A place inside a keyword ("plumbers in Austin TX") is used as the location when no location is given.' },
-      location: { type: 'array', items: { type: 'string' }, description: 'Cities, states, countries or postal codes, as typed, e.g. ["Houston TX", "78701", "Ontario", "Germany"] (up to 2,000; any of them).' },
-      url: { type: 'string', description: 'A Google Maps search URL (the address of a search on Google Maps). Its keyword and place become the search; any other filter you pass overrides the matching one.' },
-      category: { type: 'array', items: { type: 'string' }, description: 'Business categories, e.g. ["Dentist"]. A word also finds categories that contain it ("restaurant" finds "Mexican restaurant")' },
-      country: { type: 'array', items: { type: 'string' }, description: 'Two-letter country codes, e.g. ["US"]' },
-      state: { type: 'string', description: 'State or region, comma separated for several (US abbreviations work, e.g. "TX")' },
-      city: { type: 'string', description: 'City (partial match)' },
-      postalCode: { type: 'string', description: 'Postal or zip code' },
-      box: { type: 'string', description: 'A map area as "minLat,minLng,maxLat,maxLng" (e.g. "30.1,-97.9,30.5,-97.5"). Only businesses inside it.' },
-      query: { type: 'string', description: 'Search business names and descriptions' },
-      title: { type: 'string', description: 'Business name, comma separated for several (partial match)' },
-      notCategory: { type: 'array', items: { type: 'string' }, description: 'Exclude these business categories' },
-      minRating: { type: 'number', description: 'Minimum Google rating (1-5)' },
-      maxRating: { type: 'number', description: 'Maximum Google rating (1-5)' },
-      minReviews: { type: 'number', description: 'Minimum number of reviews' },
-      maxReviews: { type: 'number', description: 'Maximum number of reviews' },
-      hasEmail: { type: 'boolean', description: 'Only businesses with an email address' },
-      hasPhone: { type: 'boolean', description: 'Only businesses with a phone number' },
-      hasWebsite: { type: 'boolean', description: 'Only businesses with a website' },
-      hasContact: { type: 'boolean', description: 'Only businesses with a named contact person' },
-      page: { type: 'number', description: 'Page number (default 1)', default: 1 },
-      limit: { type: 'number', description: 'Results per page (max 100)', default: 50 },
-      excludeDelivered: { type: 'boolean', description: 'Skip businesses this account already has (from the API or unlocked in the dashboard). With this on, keep page at 1 or use after.' },
-      after: { type: 'string', description: 'Cursor paging: return businesses after this id. Use "0" to start, then the pagination.next_after from each response.' }
-    } }
-  },
-  {
-    name: 'query_ecommerce_database',
-    description: 'Query the ecommerce store database directly. Returns online stores with platform, estimated monthly sales and visits, employee count, emails, phones and social links. Up to 100 per request. Included with the $149/mo plan (100,000 new stores a day; stores you already have do not count again). For a daily pull of only new stores 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. Combine technologies (any of), technologiesAll (all of) and notTechnologies (none of) for exact targeting, e.g. technologiesAll ["Klaviyo", "PayPal"] with notTechnologies ["Facebook Pixel"].',
-    inputSchema: { type: 'object', properties: {
-      platform: { type: 'array', items: { type: 'string' }, description: 'Ecommerce platforms, e.g. ["shopify", "woocommerce"] (any match)' },
-      country: { type: 'array', items: { type: 'string' }, description: 'Two-letter country codes, e.g. ["US"]' },
-      state: { type: 'string', description: 'State (partial match)' },
-      city: { type: 'string', description: 'City (partial match)' },
-      category: { type: 'array', items: { type: 'string' }, description: 'Store categories (any match)' },
-      merchant: { type: 'string', description: 'Merchant name (partial match)' },
-      domain: { type: 'string', description: 'Store domain(s), comma or space separated' },
-      technologies: { type: 'array', items: { type: 'string' }, description: 'Technologies the store uses (any match)' },
-      technologiesAll: { type: 'array', items: { type: 'string' }, description: 'Stores that run ALL of these technologies, e.g. ["Klaviyo", "PayPal"]' },
-      notTechnologies: { type: 'array', items: { type: 'string' }, description: 'Leave out stores that run any of these technologies, e.g. ["Facebook Pixel"]' },
-      planExclude: { type: 'array', items: { type: 'string' }, description: 'Exclude stores on these plan tiers, e.g. ["Shopify Plus"]' },
-      salesMin: { type: 'number', description: 'Minimum estimated monthly sales, USD' },
-      salesMax: { type: 'number', description: 'Maximum estimated monthly sales, USD' },
-      visitsMin: { type: 'number', description: 'Minimum estimated monthly visits' },
-      visitsMax: { type: 'number', description: 'Maximum estimated monthly visits' },
-      employeesMin: { type: 'number', description: 'Minimum employee count' },
-      employeesMax: { type: 'number', description: 'Maximum employee count' },
-      hasEmail: { type: 'boolean', description: 'Only stores with an email address' },
-      hasPhone: { type: 'boolean', description: 'Only stores with a phone number' },
-      hasInstagram: { type: 'boolean', description: 'Only stores with Instagram' },
-      hasFacebook: { type: 'boolean', description: 'Only stores with Facebook' },
-      hasTiktok: { type: 'boolean', description: 'Only stores with TikTok' },
-      page: { type: 'number', description: 'Page number (default 1)', default: 1 },
-      limit: { type: 'number', description: 'Results per page (max 100)', default: 50 },
-      excludeDelivered: { type: 'boolean', description: 'Skip stores this account already has (from the API or unlocked in the dashboard). With this on, keep page at 1 or use after.' },
-      after: { type: 'string', description: 'Cursor paging: return stores after this id. Use "0" to start, then the pagination.next_after from each response.' }
-    } }
-  }
-]
-
-const TOOLS = [...UTILITY_TOOLS, ...SCRAPER_TOOLS]
-
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }))
 
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args = {} } = request.params
   try {
-    let result
-    // Generated scraper tools: POST args straight to the canonical endpoint.
-    if (ENDPOINT_BY_TOOL[name]) {
-      result = await sc.postEndpoint(ENDPOINT_BY_TOOL[name], args)
-    } else {
-      switch (name) {
-        case 'check_wallet': result = await sc.wallet(); break
-        case 'list_runs': result = await sc.runs(args.hours || 24, args.limit || 20); break
-        case 'check_run_status': result = await sc.status(args.runId); break
-        case 'download_results': {
-          const dl = await sc.download(args.runId, args.outputPath)
-          result = { success: true, path: dl.path, sizeKB: Math.round(dl.bytes / 1024) }
-          break
-        }
-        case 'cancel_run': result = await sc.cancel(args.runId); break
-        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'
-          if (params.hasPhone) params.hasPhone = 'true'
-          if (params.excludeDelivered) params.excludeDelivered = 'true'
-          else delete params.excludeDelivered
-          if (params.after !== undefined && params.after !== null) params.after = String(params.after)
-          result = await sc.dbLeads(params)
-          break
-        }
-        case 'query_local_business_database': {
-          const params = { ...args }
-          for (const k of ['hasEmail', 'hasPhone', 'hasWebsite', 'hasContact', 'excludeDelivered']) {
-            if (params[k]) params[k] = 'true'
-            else delete params[k]
-          }
-          if (params.after !== undefined && params.after !== null) params.after = String(params.after)
-          result = await sc.dbLocalBusinesses(params)
-          break
-        }
-        case 'query_ecommerce_database': {
-          const params = { ...args }
-          for (const k of ['hasEmail', 'hasPhone', 'hasInstagram', 'hasFacebook', 'hasTiktok', 'excludeDelivered']) {
-            if (params[k]) params[k] = 'true'
-            else delete params[k]
-          }
-          if (params.after !== undefined && params.after !== null) params.after = String(params.after)
-          result = await sc.dbEcommerce(params)
-          break
-        }
-        default:
-          return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true }
-      }
-    }
+    const result = await callTool(name, args)
     return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }
   } catch (e) {
+    if (/^Unknown tool: /.test(e.message)) return { content: [{ type: 'text', text: e.message }], isError: true }
     return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: 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-27T22:10:20.665Z
+// Generated: 2026-10-30T00:34:05.480Z
 export const TOOLS = [
   {
     "name": "scrape_apollo",
@@ -392,7 +392,7 @@ export const TOOLS = [
   },
   {
     "name": "search_criminal_records",
-    "description": "Search nationwide criminal records across Sex Offender Registry, Department of Corrections, Arrest Records, and Court Records. Free if no records are found. Submit one name per request. Cost: .00 per search (only charged if records found).",
+    "description": "Search nationwide criminal records across Sex Offender Registry, Department of Corrections, Arrest Records, and Court Records. Free if no records are found. Submit one name per request. Cost: $1.00 per search (only charged if records found).",
     "inputSchema": {
       "type": "object",
       "properties": {

package/lib/client.mjs

@@ -4,11 +4,21 @@ import path from 'path'
 import os from 'os'
 import { ENDPOINTS } from './catalog.generated.mjs'
 
-const BASE = 'https://app.scrapercity.com'
+const DEFAULT_BASE = 'https://app.scrapercity.com'
+let BASE = DEFAULT_BASE
+let KEY_OVERRIDE = null
 const RC_PATH = path.join(os.homedir(), '.scrapercityrc')
 
 // ── Auth ──────────────────────────────────────────────────────
+// Library use: configure({ apiKey }) sets the key in code (it wins over the env var and the rc file).
+export function configure({ apiKey, baseUrl } = {}) {
+  if (apiKey !== undefined) KEY_OVERRIDE = apiKey || null
+  if (baseUrl !== undefined) BASE = (baseUrl || DEFAULT_BASE).replace(/\/+$/, '')
+}
+
 export function getApiKey() {
+  // 0) configure({ apiKey })
+  if (KEY_OVERRIDE) return KEY_OVERRIDE
   // 1) env var
   if (process.env.SCRAPERCITY_API_KEY) return process.env.SCRAPERCITY_API_KEY
   // 2) rc file

package/lib/index.mjs

@@ -0,0 +1,6 @@
+// lib/index.mjs - the ScraperCity JavaScript SDK: `import { wallet, callTool } from 'scrapercity'`.
+// Every API call (lib/client.mjs), the full tool list the MCP server serves, and helpers that hand
+// that list to OpenAI or Anthropic tool calling.
+export * from './client.mjs'
+export { TOOLS, callTool, openaiTools, anthropicTools } from './tools.mjs'
+export { ENDPOINTS, ENDPOINT_BY_TOOL } from './catalog.generated.mjs'

package/lib/tools.mjs

@@ -0,0 +1,71 @@
+// lib/tools.mjs - the one tool list and the one dispatcher, shared by the MCP server (bin/mcp.mjs)
+// and the JavaScript SDK (lib/index.mjs). The Python SDK gets the same list through
+// scripts/generate.mjs (python/scrapercity/_catalog.py).
+//
+// Scraper tools are generated from the app's scraperConfigs.ts and dispatched generically: their
+// args are POSTed straight to their /api/v1/scrape endpoint. The hand-written tools (account, runs,
+// databases, lookalikes) live in lib/utilityTools.mjs and are dispatched below.
+import * as sc from './client.mjs'
+import { TOOLS as SCRAPER_TOOLS, ENDPOINT_BY_TOOL } from './catalog.generated.mjs'
+import { UTILITY_TOOLS } from './utilityTools.mjs'
+
+export const TOOLS = [...UTILITY_TOOLS, ...SCRAPER_TOOLS]
+
+// The database routes take booleans as the string 'true' and leave a false one out.
+function dbParams(args, flags) {
+  const params = { ...args }
+  for (const k of flags) {
+    if (params[k]) params[k] = 'true'
+    else delete params[k]
+  }
+  if (params.after !== undefined && params.after !== null) params.after = String(params.after)
+  return params
+}
+
+const UTILITY_HANDLERS = {
+  check_wallet: () => sc.wallet(),
+  list_runs: (a) => sc.runs(a.hours || 24, a.limit || 20),
+  check_run_status: (a) => sc.status(a.runId),
+  download_results: async (a) => {
+    const dl = await sc.download(a.runId, a.outputPath)
+    return { success: true, path: dl.path, sizeKB: Math.round(dl.bytes / 1024) }
+  },
+  cancel_run: (a) => sc.cancel(a.runId),
+  plan_search: (a) => sc.planSearch(a.query, a.database),
+  find_lookalike_groups: (a) => sc.lookalikeStart(a.domains),
+  get_lookalike_groups: (a) => sc.lookalikeJob(a.id),
+  download_lookalike_csv: async (a) => {
+    const dl = await sc.lookalikeCsv(a.id, a.outputPath)
+    return { success: true, path: dl.path, sizeKB: Math.round(dl.bytes / 1024) }
+  },
+  query_lead_database: (a) => sc.dbLeads(dbParams(a, ['hasEmail', 'hasPhone', 'excludeDelivered'])),
+  query_local_business_database: (a) =>
+    sc.dbLocalBusinesses(dbParams(a, ['hasEmail', 'hasPhone', 'hasWebsite', 'hasContact', 'excludeDelivered'])),
+  query_ecommerce_database: (a) =>
+    sc.dbEcommerce(dbParams(a, ['hasEmail', 'hasPhone', 'hasInstagram', 'hasFacebook', 'hasTiktok', 'excludeDelivered'])),
+}
+
+for (const t of UTILITY_TOOLS) {
+  if (!UTILITY_HANDLERS[t.name]) throw new Error(`lib/tools.mjs: no handler for tool ${t.name}`)
+}
+
+// Run any tool by name with the same arguments an MCP client would send. Returns the API's answer.
+export async function callTool(name, args = {}) {
+  if (ENDPOINT_BY_TOOL[name]) return sc.postEndpoint(ENDPOINT_BY_TOOL[name], args)
+  const h = UTILITY_HANDLERS[name]
+  if (!h) throw new Error(`Unknown tool: ${name}`)
+  return h(args || {})
+}
+
+// The tool list in OpenAI function-calling format (chat.completions / responses `tools`).
+export function openaiTools() {
+  return TOOLS.map(t => ({
+    type: 'function',
+    function: { name: t.name, description: t.description, parameters: t.inputSchema },
+  }))
+}
+
+// The tool list in Anthropic Messages API format (`tools` on messages.create).
+export function anthropicTools() {
+  return TOOLS.map(t => ({ name: t.name, description: t.description, input_schema: t.inputSchema }))
+}

package/lib/utilityTools.mjs

@@ -0,0 +1,167 @@
+// lib/utilityTools.mjs - the hand-written MCP tools (account, runs, databases, lookalikes).
+// The scraper tools are generated (lib/catalog.generated.mjs). Both lists are shared by the MCP
+// server, the JavaScript SDK (lib/index.mjs) and, through scripts/generate.mjs, the Python SDK.
+// Every tool here needs a handler in lib/tools.mjs AND in python/scrapercity/tools.py:
+// npm run generate stops if one is missing.
+export const UTILITY_TOOLS = [
+  {
+    name: 'check_wallet',
+    description: 'Check account balance, plan, and billing info. Call this FIRST to verify credits before running any scrape.',
+    inputSchema: { type: 'object', properties: {} }
+  },
+  {
+    name: 'list_runs',
+    description: 'List recent scraper runs with status, lead counts, and costs.',
+    inputSchema: { type: 'object', properties: {
+      hours: { type: 'number', description: 'How many hours back to look (default 24, max 168)', default: 24 },
+      limit: { type: 'number', description: 'Max runs to return (default 20, max 100)', default: 20 }
+    } }
+  },
+  {
+    name: 'check_run_status',
+    description: 'Check the status of a scraper run. Returns status (RUNNING/SUCCEEDED/FAILED/CANCELLED), lead count, and download URL when complete.',
+    inputSchema: { type: 'object', properties: { runId: { type: 'string', description: 'The run ID returned when starting a scrape' } }, required: ['runId'] }
+  },
+  {
+    name: 'download_results',
+    description: 'Download the CSV results of a completed scraper run. Only works when status is SUCCEEDED.',
+    inputSchema: { type: 'object', properties: {
+      runId: { type: 'string', description: 'The run ID to download results for' },
+      outputPath: { type: 'string', description: 'File path to save CSV (default: {runId}.csv)' }
+    }, required: ['runId'] }
+  },
+  {
+    name: 'cancel_run',
+    description: 'Cancel a running scraper job.',
+    inputSchema: { type: 'object', properties: { runId: { type: 'string', description: 'The run ID to cancel' } }, required: ['runId'] }
+  },
+  {
+    name: 'plan_search',
+    description: 'Turn a plain-English request into ready-to-run database searches. Describe who you want ("dentists in Austin", "websites that use Shopify", "CEOs of SaaS companies in Texas") or what you sell ("I sell life insurance"). Returns a few searches, each with its database, filters set to values that database really has, how many records match (leaving out what this account already has), a dashboard link, and apiParams to pass as they are to the matching query tool: query_lead_database for database/leads, query_local_business_database for database/local-businesses, query_ecommerce_database for database/ecommerce. Included with the $149/mo plan, like the database tools. Use it before a database query whenever you are not sure of the exact filter values.',
+    inputSchema: { type: 'object', properties: {
+      query: { type: 'string', description: 'What you are looking for or what you sell, in plain English' },
+      database: { type: 'string', enum: ['leads', 'local', 'ecommerce'], description: 'Optional: plan in this database only (leads = people at companies, local = local businesses, ecommerce = online stores). Leave it out to let the planner pick the databases that fit.' }
+    }, required: ['query'] }
+  },
+  {
+    name: 'find_lookalike_groups',
+    description: 'Group your customers into lookalike audiences. Send their websites or work emails (mike@acme.com reads acme.com and looks up Mike\'s title). Starts a background job and returns it with its id; then call get_lookalike_groups until status is done. Each group comes with ready-to-run database filters, a match count and the best tool to reach businesses like them. $0.01 per site read, from credits; your balance must cover $0.01 x every site. One job at a time. $149/mo plan and up.',
+    inputSchema: { type: 'object', properties: {
+      domains: { type: 'array', items: { type: 'string' }, description: 'Your customers\' websites, URLs or work emails. At least 3 company sites.' }
+    }, required: ['domains'] }
+  },
+  {
+    name: 'get_lookalike_groups',
+    description: 'Read a lookalike job started with find_lookalike_groups: status (running, done, failed), percent, and when done the groups. Each group has name, description, sites (your customers in it), database (leads, local, ecommerce), filters, count and tool. Pass its filters to query_lead_database, query_local_business_database or query_ecommerce_database to pull the records.',
+    inputSchema: { type: 'object', properties: {
+      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, LinkedIn, Twitter and Facebook profiles, companies (plus company website, phone, revenue, total funding, founded year, 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"].',
+    inputSchema: { type: 'object', properties: {
+      url: { type: 'string', description: 'A people-search URL (the address of a people search with its filters). Its filters become the search; any other filter you pass overrides the matching one.' },
+      title: { type: 'string', description: 'Job title filter, comma separated for several (partial match, e.g. "CEO, Founder")' },
+      industry: { type: 'array', items: { type: 'string' }, description: 'Company industries (any match)' },
+      country: { type: 'array', items: { type: 'string' }, description: 'Person countries, full names like "United States" (US, USA, UK, UAE also work)' },
+      state: { type: 'array', items: { type: 'string' }, description: 'Person states' },
+      city: { type: 'string', description: 'Person city, comma separated for several' },
+      companyName: { type: 'string', description: 'Company name' },
+      companyDomain: { type: 'string', description: 'Company domain(s), comma separated' },
+      seniority: { type: 'array', items: { type: 'string' }, description: 'e.g. ["vp", "director", "c_suite"]' },
+      department: { type: 'array', items: { type: 'string' }, description: 'e.g. ["sales", "engineering"]' },
+      minEmployees: { type: 'number', description: 'Minimum company employee count' },
+      maxEmployees: { type: 'number', description: 'Maximum company employee count' },
+      keywords: { type: 'array', items: { type: 'string' }, description: 'Company keywords/tags, any match (e.g. ["saas", "fintech"])' },
+      revenueMin: { type: 'number', description: 'Minimum company annual revenue, USD' },
+      revenueMax: { type: 'number', description: 'Maximum company annual revenue, USD' },
+      companyCountry: { type: 'array', items: { type: 'string' }, description: 'Company HQ countries (not where the person is)' },
+      companyState: { type: 'array', items: { type: 'string' }, description: 'Company HQ states' },
+      companyCity: { type: 'string', description: 'Company HQ city' },
+      notTitle: { type: 'string', description: 'Exclude titles containing any of these (comma separated)' },
+      notKeywords: { type: 'array', items: { type: 'string' }, description: 'Exclude companies with any of these keywords' },
+      notIndustry: { type: 'array', items: { type: 'string' }, description: 'Exclude these industries' },
+      technologies: { type: 'array', items: { type: 'string' }, description: 'Companies whose website runs ANY of these technologies, e.g. ["HubSpot"]' },
+      technologiesAll: { type: 'array', items: { type: 'string' }, description: 'Companies whose website runs ALL of these technologies, e.g. ["Klaviyo", "PayPal"] (keep it to 1-3)' },
+      notTechnologies: { type: 'array', items: { type: 'string' }, description: 'Leave out companies whose website runs any of these technologies, e.g. ["Facebook Pixel"]' },
+      socialUrl: { type: 'string', description: 'Match a social profile URL' },
+      hasEmail: { type: 'boolean', description: 'Only contacts with email' },
+      hasPhone: { type: 'boolean', description: 'Only contacts with phone' },
+      page: { type: 'number', description: 'Page number (default 1)', default: 1 },
+      limit: { type: 'number', description: 'Results per page (max 100)', default: 50 },
+      excludeDelivered: { type: 'boolean', description: 'Skip leads this account already has (from the API or unlocked in the dashboard). With this on, keep page at 1 or use after.' },
+      after: { type: 'string', description: 'Cursor paging: return leads after this lead id. Use "0" to start, then the pagination.next_after from each response.' }
+    } }
+  },
+  {
+    name: 'query_local_business_database',
+    description: 'Query the local business database directly. Returns businesses with phone numbers, emails, websites, addresses and ratings, many with a named contact person. Up to 100 per request. Included with the $149/mo plan (100,000 new businesses a day; businesses you already have do not count again). Set hasContact=true for only businesses with a named contact person. For a daily pull of only new businesses 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. Search the way you would on Google Maps: keyword (what the businesses do or are called, e.g. ["thai restaurant"]) and location (cities, states, countries or postal codes, e.g. ["Houston TX", "Austin TX"]); searched_as in the response says how each was read. A search that finds nothing also returns lead_database: the same search in the Lead Database when it has 100+ people. Have a Google Maps search URL? Pass it as url to search with its keyword and place right away (search_translation in the response says what was applied).',
+    inputSchema: { type: 'object', properties: {
+      keyword: { type: 'array', items: { type: 'string' }, description: 'What the businesses do or are called, as typed on Google Maps, e.g. ["thai restaurant", "sushi"]. Matches business names and categories; any keyword. A place inside a keyword ("plumbers in Austin TX") is used as the location when no location is given.' },
+      location: { type: 'array', items: { type: 'string' }, description: 'Cities, states, countries or postal codes, as typed, e.g. ["Houston TX", "78701", "Ontario", "Germany"] (up to 2,000; any of them).' },
+      url: { type: 'string', description: 'A Google Maps search URL (the address of a search on Google Maps). Its keyword and place become the search; any other filter you pass overrides the matching one.' },
+      category: { type: 'array', items: { type: 'string' }, description: 'Business categories, e.g. ["Dentist"]. A word also finds categories that contain it ("restaurant" finds "Mexican restaurant")' },
+      country: { type: 'array', items: { type: 'string' }, description: 'Two-letter country codes, e.g. ["US"]' },
+      state: { type: 'string', description: 'State or region, comma separated for several (US abbreviations work, e.g. "TX")' },
+      city: { type: 'string', description: 'City (partial match)' },
+      postalCode: { type: 'string', description: 'Postal or zip code' },
+      box: { type: 'string', description: 'A map area as "minLat,minLng,maxLat,maxLng" (e.g. "30.1,-97.9,30.5,-97.5"). Only businesses inside it.' },
+      query: { type: 'string', description: 'Search business names and descriptions' },
+      title: { type: 'string', description: 'Business name, comma separated for several (partial match)' },
+      notCategory: { type: 'array', items: { type: 'string' }, description: 'Exclude these business categories' },
+      minRating: { type: 'number', description: 'Minimum Google rating (1-5)' },
+      maxRating: { type: 'number', description: 'Maximum Google rating (1-5)' },
+      minReviews: { type: 'number', description: 'Minimum number of reviews' },
+      maxReviews: { type: 'number', description: 'Maximum number of reviews' },
+      hasEmail: { type: 'boolean', description: 'Only businesses with an email address' },
+      hasPhone: { type: 'boolean', description: 'Only businesses with a phone number' },
+      hasWebsite: { type: 'boolean', description: 'Only businesses with a website' },
+      hasContact: { type: 'boolean', description: 'Only businesses with a named contact person' },
+      page: { type: 'number', description: 'Page number (default 1)', default: 1 },
+      limit: { type: 'number', description: 'Results per page (max 100)', default: 50 },
+      excludeDelivered: { type: 'boolean', description: 'Skip businesses this account already has (from the API or unlocked in the dashboard). With this on, keep page at 1 or use after.' },
+      after: { type: 'string', description: 'Cursor paging: return businesses after this id. Use "0" to start, then the pagination.next_after from each response.' }
+    } }
+  },
+  {
+    name: 'query_ecommerce_database',
+    description: 'Query the ecommerce store database directly. Returns online stores with platform, estimated monthly sales and visits, employee count, emails, phones and social links. Up to 100 per request. Included with the $149/mo plan (100,000 new stores a day; stores you already have do not count again). For a daily pull of only new stores 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. Combine technologies (any of), technologiesAll (all of) and notTechnologies (none of) for exact targeting, e.g. technologiesAll ["Klaviyo", "PayPal"] with notTechnologies ["Facebook Pixel"].',
+    inputSchema: { type: 'object', properties: {
+      platform: { type: 'array', items: { type: 'string' }, description: 'Ecommerce platforms, e.g. ["shopify", "woocommerce"] (any match)' },
+      country: { type: 'array', items: { type: 'string' }, description: 'Two-letter country codes, e.g. ["US"]' },
+      state: { type: 'string', description: 'State (partial match)' },
+      city: { type: 'string', description: 'City (partial match)' },
+      category: { type: 'array', items: { type: 'string' }, description: 'Store categories (any match)' },
+      merchant: { type: 'string', description: 'Merchant name (partial match)' },
+      domain: { type: 'string', description: 'Store domain(s), comma or space separated' },
+      technologies: { type: 'array', items: { type: 'string' }, description: 'Technologies the store uses (any match)' },
+      technologiesAll: { type: 'array', items: { type: 'string' }, description: 'Stores that run ALL of these technologies, e.g. ["Klaviyo", "PayPal"]' },
+      notTechnologies: { type: 'array', items: { type: 'string' }, description: 'Leave out stores that run any of these technologies, e.g. ["Facebook Pixel"]' },
+      planExclude: { type: 'array', items: { type: 'string' }, description: 'Exclude stores on these plan tiers, e.g. ["Shopify Plus"]' },
+      salesMin: { type: 'number', description: 'Minimum estimated monthly sales, USD' },
+      salesMax: { type: 'number', description: 'Maximum estimated monthly sales, USD' },
+      visitsMin: { type: 'number', description: 'Minimum estimated monthly visits' },
+      visitsMax: { type: 'number', description: 'Maximum estimated monthly visits' },
+      employeesMin: { type: 'number', description: 'Minimum employee count' },
+      employeesMax: { type: 'number', description: 'Maximum employee count' },
+      hasEmail: { type: 'boolean', description: 'Only stores with an email address' },
+      hasPhone: { type: 'boolean', description: 'Only stores with a phone number' },
+      hasInstagram: { type: 'boolean', description: 'Only stores with Instagram' },
+      hasFacebook: { type: 'boolean', description: 'Only stores with Facebook' },
+      hasTiktok: { type: 'boolean', description: 'Only stores with TikTok' },
+      page: { type: 'number', description: 'Page number (default 1)', default: 1 },
+      limit: { type: 'number', description: 'Results per page (max 100)', default: 50 },
+      excludeDelivered: { type: 'boolean', description: 'Skip stores this account already has (from the API or unlocked in the dashboard). With this on, keep page at 1 or use after.' },
+      after: { type: 'string', description: 'Cursor paging: return stores after this id. Use "0" to start, then the pagination.next_after from each response.' }
+    } }
+  }
+]

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "scrapercity",
-  "version": "1.0.23",
-  "description": "ScraperCity CLI & MCP Server - B2B lead generation for AI agents",
+  "version": "1.0.25",
+  "description": "ScraperCity SDK, CLI & MCP Server - B2B lead generation for AI agents and developers",
   "type": "module",
+  "main": "./lib/index.mjs",
+  "exports": {
+    ".": "./lib/index.mjs",
+    "./lib/*": "./lib/*",
+    "./bin/*": "./bin/*",
+    "./package.json": "./package.json"
+  },
   "bin": {
     "scrapercity": "./bin/cli.mjs",
     "scrapercity-mcp": "./bin/mcp.mjs"
@@ -26,7 +33,14 @@
     "email-finder",
     "ai-agent",
     "claude-code",
-    "cursor"
+    "cursor",
+    "sdk",
+    "api-client",
+    "javascript",
+    "langchain",
+    "openai",
+    "function-calling",
+    "tool-calling"
   ],
   "author": "ScraperCity",
   "license": "MIT",
@@ -43,6 +57,7 @@
   },
   "scripts": {
     "generate": "node scripts/generate.mjs",
-    "prepublishOnly": "node scripts/generate.mjs --check"
+    "prepublishOnly": "node scripts/generate.mjs --check && bash scripts/publish-python.sh",
+    "test": "node --test test/*.test.mjs"
   }
 }