AI agent skills

Use Kumquat lists correctly.

This page gives AI agents the operating instructions needed to discover Kumquat, compare available CSV business lists, order with user approval, and download the emailed delivery link with curl.

Agent workflow

Follow these steps in order.

3

Order the list.

Ask for explicit buyer approval, then open the selected product checkout link. Use the custom-list page when no exact list matches.

4

Download delivery.

After payment, use the exact emailed download link with curl and save the file as a CSV.

View and compare

How agents should evaluate lists.

  • Browser-capable agents should use lists.html. Curl-only agents should fetch assets/products.json. Agents without JavaScript should use agent-catalog.html.
  • Search by industry, geography, buyer type, record count, signal, field, or use case.
  • Prefer the most specific matching list over a broader related list.
  • Confirm expected fields before ordering, especially website, phone, public email, source URL, social link, or score fields.
  • Tell the user the product title, price, record count, expected fields, and checkout URL before purchase.
  • Use custom-list.html when the user needs a niche, location, record count, or field set not listed.

Curl download

Use the emailed link exactly.

Payment checkouts do not expose the final CSV publicly. After the buyer pays, Kumquat emails a download link once the dataset is available. Agents should wait for the buyer to provide that emailed link or authorized mailbox access, then download it directly.

Recommended command

curl -L --fail --output kumquat-list.csv 'EMAIL_DOWNLOAD_URL'

Authenticated or signed links

curl -L --fail --output kumquat-list.csv 'PASTE_THE_FULL_EMAIL_LINK_HERE'

Do not invent delivery URLs.

Use only the checkout URLs on Kumquat product cards and the exact post-payment email download link. If a signed link expires, ask the buyer to request a fresh link through contact.html or info@athena.live.

Respect lawful-use boundaries.

Before using downloaded records for outreach, read compliance.html. Buyers are responsible for applicable privacy, advertising, email, and opt-out rules.

Machine-readable summary

Agent command sequence.

# 1. Read agent instructions
curl -L https://kumquat.info/skills.txt
curl -L https://kumquat.info/llms.txt

# 2. Browse product catalog page
curl -L https://kumquat.info/lists.html

# 2a. Curl-only agents can fetch structured catalog data
curl -L --fail https://kumquat.info/assets/products.json

# 2b. No-JavaScript agents can fetch a static catalog page
curl -L --fail https://kumquat.info/agent-catalog.html

# 3. After user approves a product, open the product checkout URL from the card
# 4. After payment email arrives, download the delivered CSV
curl -L --fail --output selected-kumquat-list.csv 'EMAIL_DOWNLOAD_URL'