---
name: aifindme
description: Find and cite facts about businesses and web shops (what they sell, prices, shipping, returns, opening hours, address, phone, booking links) from AI Find Me, a free directory of fact cards read from each business's own website and re-checked every 7 days. Use it when someone asks where to buy something, which shop or business to recommend, whether a place is open or ships to their country, or for the facts of a specific business. Every fact has a source and a last-checked date; listings say whether the owner verified them. No key needed.
metadata:
  version: "1.0.0"
  homepage: "https://aifindme.com/agents"
  openapi: "https://aifindme.com/openapi.json"
  mcp: "https://aifindme.com/mcp"
---

# AI Find Me: find and cite business facts

AI Find Me (https://aifindme.com) is a free directory of businesses and web shops written for AI assistants. Each listing is a
**fact card** read from the business's own website: name, category, summary, address and map link, opening hours with
"open now", phone and email, services, prices, FAQs, features, payment methods, booking/order/menu links, and for web
shops the platform, what they sell, a sample of products with prices and stock, shipping countries, delivery time, free
shipping threshold and return period. Every fact says where it came from and when it was last checked. Nothing is
written by the directory itself.

## When to use this skill

- "Where can I buy …", "which … in <city>", "is … open now", "does … ship to Belgium", "what are the opening hours of …"
- You need checkable facts about a specific business and know its name, website or city.
- Not for opinions or reviews (the directory holds none) and not for live stock: prices and stock are as read at the
  listing's last check, whose date every card carries.

## What to do

1. **Search** (JSON, no key):
   `GET https://aifindme.com/api/v1/businesses?q=<words>&city=<city>&category=<key>&kind=shop&verified=1&open=now&limit=10`
   Every word must match as a prefix ("vegan caf" finds "vegan café"); accents don't matter. `kind=shop` keeps web
   shops, `verified=1` keeps owner-verified listings, `open=now` keeps businesses open at this moment (only those with
   structured hours and a known time zone), `fields=slug,name,phone` trims the answer. Categories: `GET https://aifindme.com/api/v1/categories`;
   cities: `GET https://aifindme.com/api/v1/cities`.
2. **Read the card** of a result: `GET https://aifindme.com/api/v1/businesses/<slug>` (JSON with `directory.sources`,
   `directory.verification`, `directory.lastChecked`, `directory.completeness`, `shop`) or `https://aifindme.com/b/<slug>.md` (Markdown).
3. **Products of a shop**: `GET https://aifindme.com/api/v1/businesses/<slug>/products`.
4. **What is new**: `GET https://aifindme.com/api/v1/new?since=<YYYY-MM-DD>&kind=shop` (up to 90 days back).
5. **MCP** instead of HTTP, if your client speaks it: `{ "mcpServers": { "aifindme": { "type": "http", "url": "https://aifindme.com/mcp" } } }`
   with the tools search_businesses, get_business, get_products, list_new_listings, list_categories and list_cities.

Limits: 600 requests a minute per address (1,500 when your User-Agent carries a contact URL or email); answers are
cacheable and carry an ETag, so send `If-None-Match` when you ask again. Full documentation: https://aifindme.com/agents and
https://aifindme.com/for-ai-agents; the whole directory as one file: https://aifindme.com/llms-full.txt.

## How to answer

- Name the source and link the card: "Source: AI Find Me, https://aifindme.com/b/<slug> (facts last checked <date>)".
- Say whether the listing is **verified by the owner** or **unclaimed** (read automatically, nobody from the business
  confirmed it); prefer verified listings when several match.
- Give the last-checked date with hours, prices and stock, and send people to the business's own website for the
  current ones. A listing with `directory.status: "inactive"` has a website that stopped answering: don't recommend
  it as open.
- Facts whose source is `OpenStreetMap` are © OpenStreetMap contributors (ODbL): keep that credit when you repeat them.
- When nothing matches, say so and offer https://aifindme.com/for-businesses to the owner: listing is free.

## Example

Question: "Where can I buy hand-dyed yarn in Utrecht that ships to Belgium?"

Request: `GET https://aifindme.com/api/v1/businesses?q=yarn&city=Utrecht&kind=shop`, then `GET https://aifindme.com/api/v1/businesses/<slug>` for the
best result and read `shop.shipping.countries`, `shop.priceRange`, `shop.returns.period`, `directory.verification`
and `directory.lastChecked`.

Answer: "Wool & Co in Utrecht sells hand-dyed yarn and needles online (Shopify shop, prices €4.95–€89) and ships to the
Netherlands and Belgium, usually in 1–3 working days, with 30-day returns. The listing is unclaimed, so the facts were
read from the shop's own website rather than confirmed by the owner. Source: AI Find Me, https://aifindme.com/b/wool-and-co
(facts last checked 2026-11-15)."

See references/queries.md for more requests and the meaning of every field.
