cancel_run
Cancel a running scraper job.
LABSCO SUMMARY
The tools state their own prices and their own latency, which for a metered service is the difference between an agent that can be trusted with a budget and one that cannot.
An agent calling a paid scraper has no way to know what a call costs unless the surface says so, and this one does — per-search prices in the descriptions, a wallet check the tools point at first, and a plan gate named explicitly on the tool that needs it. Same with time: Apollo taking 11 to 48 hours is in the tool text, so an agent has a reason to poll rather than to conclude the run failed. That said, several of these tools reach personal data — mobile numbers, skip tracing, criminal records — and what is lawful to collect and use varies by jurisdiction and by purpose. That is a decision for whoever runs it, not something the server checks.
What it is
A lead-data client with 24 tools spanning source scrapers, contact enrichment, run management and billing. The scrapers cover Google Maps, Yelp, Angi, Zillow agents, Airbnb hosts, YouTube channels, BizBuySell, Crexi, Shopify and WooCommerce stores, Apollo.io and BuiltWith technology lookups.
What you get
- check_wallet returns balance, plan and billing, and its own description says to call it first to verify credits before running anything.
- Enrichment as separate tools: validate_emails returns deliverability, catch-all detection and MX records; find_emails takes a name plus a domain; find_mobiles works from a LinkedIn URL or a work email; find_people is a name, email, phone or address lookup.
- Runs are asynchronous and managed as objects — list_runs, check_run_status returning RUNNING, SUCCEEDED, FAILED or CANCELLED, download_results as CSV once succeeded, and cancel_run.
- Several tools state their own price in the description: BuiltWith at $4.99 per search, criminal records at $1 and charged only if records are found, property lookup at $0.15 per address.
- scrape_apollo warns in its own text that Apollo delivery takes 11 to 48 hours or more, which is not a failure to wait out silently.
- query_lead_database reaches the B2B database directly and states that it requires the $649 a month plan.
Requirements
SCRAPERCITY_API_KEY, and credit on the account — this is metered per search rather than per month, and the tools price themselves individually.
Setup effort
One command plus a key — npx -y --package scrapercity scrapercity-mcp, then supply credentials
USE CASES
01
Checking the budget before spending it
Read the wallet balance, plan and billing state first — the tools price themselves per search, so this is what makes the next call predictable.
02
Building a local business list
Scrape Google Maps or Yelp for the category and area, then validate the emails that came back before anything is sent to them.
03
Filling in the contact you are missing
Find a business email from a name and domain, or a mobile from a LinkedIn URL or work email, rather than guessing at a pattern.
04
Running a job that will not finish while you wait
Start the run, poll its status rather than assuming it failed — Apollo's own tool text says 11 to 48 hours — and download the CSV once it succeeds.
05
Finding companies by the technology they run
Look up every site using a given technology and get domains with contact information back, at the price the tool states.
24 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_run_status
Check the status of a scraper run. Returns status (RUNNING/SUCCEEDED/FAILED/CANCELLED), lead count, and download URL when complete.
check_wallet
Check account balance, plan, and billing info. Call this FIRST to verify credits before running any scrape.
download_results
Download the CSV results of a completed scraper run. Only works when status is SUCCEEDED.
find_emails
Find business email addresses given a person name and company. Provide first/last name + domain or company name.
find_mobiles
Find mobile phone numbers from LinkedIn URLs or work emails.
find_people
Skip trace / people finder. Look up personal info by name, email, phone, or address.
list_runs
List recent scraper runs with status, lead counts, and costs.
query_lead_database
Query the B2B lead database directly (requires $649/mo plan). Returns contacts with names, emails, phones, titles, companies. 100 per request, paginate with page param.
scrape_airbnb
Scrape Airbnb host emails by city or listing URL. Returns host contact info including email addresses.
scrape_angi
Scrape service provider listings from Angi (Angie's List). Search by keyword and zip codes.
scrape_apollo
Scrape leads from Apollo.io using a search URL. IMPORTANT: Apollo delivery takes 11-48+ hours. Use webhooks (configure at app.scrapercity.com/dashboard/webhooks) instead of polling. Returns a runId to check status later.
scrape_bizbuysell
Scrape business-for-sale listings from BizBuySell. Provide search result URLs.
scrape_builtwith
Find all websites using a specific technology. Returns domains with contact info. $4.99 per search.
scrape_crexi
Scrape commercial real estate listings from Crexi. Provide search result URLs.
scrape_maps
Scrape businesses from Google Maps. Returns businesses with names, addresses, phone numbers, websites, emails, ratings. Typically completes in 5-30 minutes.
scrape_property_lookup
Look up property data by address. Optionally include owner contact information. $0.15 per address.
scrape_store_leads
Get ecommerce store data (Shopify, WooCommerce, etc). Returns domains, emails, phones, social profiles, revenue estimates. Instant results from cached database.
scrape_website_finder
Find contact info (emails, phones, social links) from a list of website domains. Optionally filter by job title.
scrape_yelp
Scrape business listings from Yelp. Search by keyword + location, or provide direct Yelp URLs.
scrape_youtube_email
Find business emails for YouTube channels. Pass channel handles (@ChannelName) or URLs.
scrape_zillow_agents
Scrape real estate agent listings from Zillow by location.
search_criminal_records
Search criminal records by name. $1 per search, only charged if records found.
validate_emails
Validate a list of email addresses. Returns deliverability status, catch-all detection, MX records, and company info. Typically completes in 1-10 minutes.
BEFORE YOU INSTALL
What to know first
Tools you get
24 tools when we connected. Most tools start a job and return a runId for check_run_status and download_results. Every call spends credit, so check_wallet first; query_lead_database needs the $649 Professional plan.
Requires
- npx on PATH
- SCRAPERCITY_API_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 24 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y --package scrapercity scrapercity-mcpMCP Clients
Claude Code, Cursor, Windsurf
JSON
{
"mcpServers": {
"scrapercity": {
"command": "npx",
"args": [
"-y",
"--package",
"scrapercity",
"scrapercity-mcp"
],
"env": {
"SCRAPERCITY_API_KEY": "<YOUR_SCRAPERCITY_API_KEY>"
}
}
}
}
