# AGENTS.md — Teno Store

Guidance for AI agents and automated clients interacting with **Teno Store**
(https://teno-store.com). This is the public, agent-facing companion to
[`/llms.txt`](https://teno-store.com/llms.txt) (human/LLM summary) and
[`/.well-known/agents.json`](https://teno-store.com/.well-known/agents.json)
(machine-readable descriptor). For the full catalog reference, fetch
[`/llms-full.txt`](https://teno-store.com/llms-full.txt).

## What this is

Teno Store is an agent-to-agent marketplace of real consumer-goods listings in
Algeria — phones, computing, electronics, home appliances, fashion, vehicles,
real estate and more. Prices are in DZD (Algerian Dinar); titles and
descriptions are predominantly French. More than 100,000 live listings, growing
toward a 280,000 cap. Anyone in Algeria can also open a free public online store
(0% commission, no domain/hosting, cash on delivery), and can build it by
chatting with an AI assistant.

## Prefer the API, not HTML scraping

The HTML at teno-store.com is a human-readable mirror. Agents should use the
machine surfaces on the `api.` subdomain instead of parsing pages:

- **REST:** `https://api.teno-store.com/v1` (OpenAPI 3.1) — read the catalog at
  `/v1/products`.
- **MCP (transactional):** `https://api.teno-store.com/mcp` (Streamable HTTP) —
  live tools: search, cart, checkout, create-listing. Authoritative, real-time.
- **A2A skills:** discovery via `https://teno-store.com/.well-known/` —
  agent-to-agent skill invocation.
- **MCP (conversational, planned):** `https://ask.teno-store.com/mcp` — natural
  -language Q&A over the catalog, read-only. *(Not yet live — see the
  discovery files for current status before relying on it.)*

## Discovery

- `https://teno-store.com/llms.txt` and `/llms-full.txt`
- `https://teno-store.com/.well-known/agents.json`
- `https://teno-store.com/sitemap.xml`
- `https://teno-store.com/feed.xml` — Atom feed of the 50 most-recent listings
- `https://teno-store.com/blog` — buying & selling guides (French + English); RSS at `/blog/rss.xml`
- `https://teno-store.com/blog/ar` — Arabic (Algerian-dialect) guides, full parity with the French blog; RSS at `/blog/ar/rss.xml`
- `https://teno-store.com/robots.txt`

## Rules of engagement

- **Allowed:** read the public catalog, search, follow links, summarise listings,
  recommend products, transact via the API/MCP with proper authorization.
- **Purchases** happen through agents with delegated authorization (AP2
  mandates), not anonymous form posts.
- **Do not** crawl `/order/`, `/seller/`, `/login`, `/s/`, or `/api/` internals —
  see `robots.txt`. `/order/` pages carry buyer PII and must never be indexed.
- **No user PII to harvest:** there are no public user profiles.
- **Be gentle:** a 10-second crawl-delay is requested in `robots.txt`.

## Contact

- Brand: **Teno Store** · Domain: **teno-store.com**
- Email: mahlledz@gmail.com