---
name: kazkn-data-tools
title: KazKN data tools for AI agents
url: https://kazkndata.com/agents.md
supported_surfaces: [mcp, api]
description: >-
  How an AI agent connects to the 12 data tools published by KazKN on Apify, picks the right one, runs it
  and reads the rows: Vinted, Vestiaire Collective, LoopNet, Crexi, Shopify apps, the App Store, YouTube channels,
  company websites and more.
---

# AGENTS.md - KazKN data tools

KazKN is an independent developer who publishes 12 ready-to-run data tools on Apify. On Apify a tool is called an
**Actor**: a cloud program that takes JSON input and writes its results as rows in a **dataset**. Each KazKN tool is billed
per result to the user's own Apify account. KazKN is not affiliated with Apify.

## Start here

- **You were given only this link, or a task that needs data from one of the sources below.** Connect the MCP server, then
  follow "Run a tool". If the session has no task yet, the setup is the task: do it, then ask what data the user wants.
- **You were asked a question about these tools** (what they return, what they cost). Answer from "The tools" below and from
  each tool's page. No setup needed.
- **You are writing code that keeps running** (a server, a scheduled job). Skip MCP and use the Apify API with a token, as in
  "Run from code".

## Connect over MCP

One remote server, reached over streamable HTTP, already limited to the KazKN tools:

```
https://mcp.apify.com/?tools=kazkn/vinted-smart-scraper,kazkn/commercial-real-estate-brokerage-intel,kazkn/vinted-turbo-scraper,kazkn/vestiaire-collective-smart-scraper,kazkn/crexi-search-actor,kazkn/shopify-scraper-apps-spy,kazkn/youtube-creator-lead-finder,kazkn/apple-app-store-localization-scraper,kazkn/hermes-birkin-kelly-arbitrage,kazkn/social-media-sentiment-monitor,kazkn/website-contact-details-scraper,kazkn/hosted-iac-policy-scan-api
```

Most MCP clients take it as:

```json
{
  "mcpServers": {
    "kazkn-tools": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=kazkn/vinted-smart-scraper,kazkn/commercial-real-estate-brokerage-intel,kazkn/vinted-turbo-scraper,kazkn/vestiaire-collective-smart-scraper,kazkn/crexi-search-actor,kazkn/shopify-scraper-apps-spy,kazkn/youtube-creator-lead-finder,kazkn/apple-app-store-localization-scraper,kazkn/hermes-birkin-kelly-arbitrage,kazkn/social-media-sentiment-monitor,kazkn/website-contact-details-scraper,kazkn/hosted-iac-policy-scan-api"
    }
  }
}
```

Client documentation is the source of truth for where this goes. Common setups:

- Claude Code: `claude mcp add --transport http --scope user kazkn "https://mcp.apify.com/?tools=kazkn/vinted-smart-scraper,kazkn/commercial-real-estate-brokerage-intel,kazkn/vinted-turbo-scraper,kazkn/vestiaire-collective-smart-scraper,kazkn/crexi-search-actor,kazkn/shopify-scraper-apps-spy,kazkn/youtube-creator-lead-finder,kazkn/apple-app-store-localization-scraper,kazkn/hermes-birkin-kelly-arbitrage,kazkn/social-media-sentiment-monitor,kazkn/website-contact-details-scraper,kazkn/hosted-iac-policy-scan-api"`
- Codex: add `[mcp_servers.kazkn]` with `url = "https://mcp.apify.com/?tools=kazkn/vinted-smart-scraper,kazkn/commercial-real-estate-brokerage-intel,kazkn/vinted-turbo-scraper,kazkn/vestiaire-collective-smart-scraper,kazkn/crexi-search-actor,kazkn/shopify-scraper-apps-spy,kazkn/youtube-creator-lead-finder,kazkn/apple-app-store-localization-scraper,kazkn/hermes-birkin-kelly-arbitrage,kazkn/social-media-sentiment-monitor,kazkn/website-contact-details-scraper,kazkn/hosted-iac-policy-scan-api"` to `~/.codex/config.toml`
- Cursor, Claude.ai and ChatGPT: links in the "Copy setup for AI" menu on https://kazkndata.com/

The configuration holds no token. The first call opens a browser sign-in to Apify, where the user approves the connection.
A user without an Apify account can create one in the same flow; Apify's free plan includes monthly usage credit. Ask the
user to finish the sign-in or reconnect the client when needed, then carry on with their task. You are connected when you
can list or call the tools. A configuration pasted in the chat is not a connection.

## Run a tool

1. **Pick the tool** from "The tools" by the source the user named (Vinted, LoopNet, a list of websites...).
2. **Read its input schema** with `fetch-actor-details` (or the tool's page). Build the input from the schema; the example
   inputs below are a good start.
3. **Tell the user the price before the first paid run** of the session: the tool's price per 1,000 results and your
   estimate for this run. Wait for a go-ahead once, not before every call. Keep the first run small with the tool's own
   limit field, and cap the bill with `maxTotalChargeUsd` in the call options.
4. **Run it** with `call-actor` and the Actor ID (`kazkn/<name>`). A long run returns a run ID: poll `get-actor-run` until it
   is `SUCCEEDED`, `FAILED`, `TIMED-OUT` or `ABORTED`.
5. **Read the rows** with `get-dataset-items` and the dataset ID. The run status never contains the rows themselves.
6. **On failure**, read the run's `statusMessage`, fix the input, and say what went wrong before retrying.

## The tools

### Vinted Smart Scraper: Listings, Sellers & Prices

- Actor ID: `kazkn/vinted-smart-scraper`
- Price: $2.50 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/vinted-smart-scraper/
- On Apify: https://apify.com/kazkn/vinted-smart-scraper
- Example input: `{"workflowPreset": "QUICK_SEARCH", "query": "nike air force 1", "countries": ["fr"], "maxItems": 20}`

Vinted Smart Scraper pulls public Vinted listings, seller profiles and price data from 26 country sites, from vinted.fr and vinted.de to vinted.co.uk and vinted.com, into structured rows. It is built for resellers who source in one country and sell in another, for analysts tracking second-hand prices, and for developers who need Vinted data in a spreadsheet or an API.

### LoopNet + Crexi Scraper

- Actor ID: `kazkn/commercial-real-estate-brokerage-intel`
- Price: $18.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/commercial-real-estate-brokerage-intel/
- On Apify: https://apify.com/kazkn/commercial-real-estate-brokerage-intel
- Example input: `{"city": "Dallas", "state": "TX", "maxResultsPerSource": 100}`

Pulls public commercial real estate listings from LoopNet and Crexi, merges them, removes listings that appear on both, and normalizes price, size and cap rate. Built for brokers, acquisition teams and analysts who rebuild the same market spreadsheet every week.

### Vinted Turbo Scraper: Search, Seller & Item URLs

- Actor ID: `kazkn/vinted-turbo-scraper`
- Price: $3.50 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/vinted-turbo-scraper/
- On Apify: https://apify.com/kazkn/vinted-turbo-scraper
- Example input: `{"startUrls": "https://www.vinted.fr/catalog?search_text=nike+dunk&order=newest_first"}`

Vinted Turbo Scraper reads the Vinted pages you point it at (searches, brand and category pages, seller wardrobes or single items) and returns each listing as a structured row with price, brand, size, condition, photos and seller. It is built for resellers, analysts, shops and developers who need Vinted data in a spreadsheet or an app instead of a browser tab.

### Vestiaire Collective Scraper: Sold Items & Export

- Actor ID: `kazkn/vestiaire-collective-smart-scraper`
- Price: $25.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/vestiaire-collective-smart-scraper/
- On Apify: https://apify.com/kazkn/vestiaire-collective-smart-scraper
- Example input: `{"searchTerms": ["chanel classic flap"], "countries": ["FR"], "sellerCountries": ["ALL"], "maxListings": 5}`

This Apify actor collects public Vestiaire Collective listings and sold-search results, with price, currency, condition, brand, model, images and seller country for each item. It is made for luxury resellers, buyers and analysts who need resale prices in a file or through an API instead of copying them by hand.

### Crexi Scraper for Commercial Real Estate

- Actor ID: `kazkn/crexi-search-actor`
- Price: $3.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/crexi-search-actor/
- On Apify: https://apify.com/kazkn/crexi-search-actor
- Example input: `{"city": "Austin", "state": "TX"}`

Turns a Crexi market search or listing URL into structured rows with asking terms, property facts, cap rate and source links. No Crexi account or cookies needed.

### Shopify Apps Spy + Product Scraper

- Actor ID: `kazkn/shopify-scraper-apps-spy`
- Price: $3.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/shopify-scraper-apps-spy/
- On Apify: https://apify.com/kazkn/shopify-scraper-apps-spy
- Example input: `{"store_urls": ["https://allbirds.com"]}`

Paste Shopify store URLs and get back each store's product catalog, the storefront apps it uses (Klaviyo, Recharge, Yotpo, Gorgias and many others) and, if you want them, public reviews from Yotpo, Judge.me, Stamped, Okendo or Loox. It is for SaaS sales teams, agencies, DTC analysts and product researchers who need Shopify data in a spreadsheet or through an API, with no store login.

### YouTube Channel Finder: Qualified Creator Leads

- Actor ID: `kazkn/youtube-creator-lead-finder`
- Price: $18.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/youtube-creator-lead-finder/
- On Apify: https://apify.com/kazkn/youtube-creator-lead-finder
- Example input: `{}`

This YouTube channel finder searches public YouTube data by niche, keyword, language and country, then returns one row per qualified channel with upload cadence, recent median views, engagement, format mix, a ranked score and any business contact the creator lists publicly in the channel description. It is made for influencer agencies, brands, sponsors, affiliate teams and SaaS companies that need a short, checked list of active creators to contact rather than a raw dump of channel links.

### App Store Scraper for Localization Gaps

- Actor ID: `kazkn/apple-app-store-localization-scraper`
- Price: $5.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/apple-app-store-localization-scraper/
- On Apify: https://apify.com/kazkn/apple-app-store-localization-scraper
- Example input: `{}`

This actor reads public Apple App Store data (search results, app metadata, declared languages and country-specific customer reviews) and returns one scored row per app showing which of your chosen languages it does not support. It is made for indie developers, ASO specialists and product researchers who want evidence before building a localized version of an app or entering a new market.

### Hermes Birkin/Kelly & Chanel Classic Cross-Platform Arbitrage

- Actor ID: `kazkn/hermes-birkin-kelly-arbitrage`
- Price: $3.00 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/hermes-birkin-kelly-arbitrage/
- On Apify: https://apify.com/kazkn/hermes-birkin-kelly-arbitrage
- Example input: `{"platforms": ["vestiaire", "rebag", "fashionphile", "1stdibs"], "models": ["birkin", "kelly", "classic_flap"]}`

This Apify actor reads public Hermes Birkin, Hermes Kelly and Chanel Classic Flap listings on Vestiaire Collective, Rebag, Fashionphile and 1stDibs, then puts model, size, color, leather, hardware, condition and price into one consistent table. It is built for resellers, sourcing teams and personal shoppers who want to spot price gaps between marketplaces and check whether they still hold up after fees and costs.

### Comment & Review Sentiment Analysis

- Actor ID: `kazkn/social-media-sentiment-monitor`
- Price: $1.50 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/social-media-sentiment-monitor/
- On Apify: https://apify.com/kazkn/social-media-sentiment-monitor
- Example input: `{"texts": [{"id": "comment-1", "text": "I love this product and the delivery was fast."}, {"id": "comment-2", "text": "Le colis est arrive en retard."}], "stateKey": "brand-weekly"}`

This comment sentiment analysis tool reads comments and reviews you already collected, either from an Apify Dataset or as a pasted list, and returns one row per comment with its sentiment, detected language, duplicate and spam flags and, in monitor mode, whether it is new or changed since the last run. It is built for brand and community managers, e-commerce and support teams, agencies and analysts who handle comments in English, French, German, Spanish, Italian or Portuguese and do not want to send them to an outside AI service.

### Contact Details Scraper for Websites

- Actor ID: `kazkn/website-contact-details-scraper`
- Price: $0.60 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/website-contact-details-scraper/
- On Apify: https://apify.com/kazkn/website-contact-details-scraper
- Example input: `{"urls": ["https://apify.com", "https://buffer.com", "https://basecamp.com", "https://abcplumbing.com"], "maxItems": 10, "maxPagesPerDomain": 5, "onlyGenericEmails": false}`

This contact details scraper visits each website on your list, reads the home page plus its contact, imprint, legal and about pages, and returns the email addresses, phone numbers, social profile links and company name it finds there, each email and phone tied to the page it came from. It is made for sales teams, agencies, researchers, recruiters and developers who already know which companies they want to reach and need their public contact channels in a spreadsheet or through an API.

### IaC Security Misconfiguration Scanner API

- Actor ID: `kazkn/hosted-iac-policy-scan-api`
- Price: $500 per 1,000 results, billed by Apify
- Page: https://kazkndata.com/actors/hosted-iac-policy-scan-api/
- On Apify: https://apify.com/kazkn/hosted-iac-policy-scan-api
- Example input: `{"sourceType": "github", "repositoryUrl": "https://github.com/DataKazKN/iac-security-scan-examples", "repositoryRef": "ad600c04599f8a1d353639252ee12d2a5976a732", "subdirectory": "fixtures/terraform"}`

This hosted IaC security scanner runs Checkov 3.3.8 on a GitHub repository or a ZIP you upload and returns one row per failed policy, with the file, resource and line range, plus a JSON summary with a PASS, FAIL or UNKNOWN gate. It covers 20 formats including Terraform, Kubernetes, Helm, Dockerfile, CloudFormation and GitHub Actions, and is meant for platform, DevSecOps and cloud security teams who want scan results without running their own scanner.

## Run from code

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("kazkn/<name>").call(run_input={...})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row)
```

REST: `POST https://api.apify.com/v2/acts/kazkn~<name>/run-sync-get-dataset-items?token=$APIFY_TOKEN` with the input as
the JSON body returns the rows directly for short runs. The token is in Apify Console, Settings, API & Integrations.

## Rules

- The tools read public pages. The user is responsible for using the data lawfully, including data protection law for
  any personal data (names, emails, phone numbers), and for respecting the terms of the source sites.
- Do not invent rows, prices or counts. If a run returns nothing, say so.

## Guides

- [App Store Scraper Python: DIY Script vs Hosted Tool for Localization](https://kazkndata.com/blog/app-store-scraper-python/)
- [How to Extract Emails From a Website List (Plus Phones and Socials)](https://kazkndata.com/blog/extract-emails-from-website/)
- [Hermes Birkin Resale Price: Real Asking Prices Across Resale Sites](https://kazkndata.com/blog/hermes-birkin-resale-price/)
- [LoopNet API and Crexi API: how to export commercial listings](https://kazkndata.com/blog/loopnet-api-crexi-api/)
- [Vinted API: Is There One, and How to Get Vinted Data in Python](https://kazkndata.com/blog/vinted-api/)
- [YouTube Channel Email Finder: Build a Creator List the Right Way](https://kazkndata.com/blog/youtube-channel-email-finder/)

## Contact

Custom scrapers, one-off datasets and questions: hello@kazkndata.com. Site: https://kazkndata.com/