# Teno Store

> Teno Store is an agent-to-agent marketplace with a real, growing catalog of
> consumer goods listed for sale in Algeria — phones, computing, electronics,
> home appliances, fashion, vehicles and accessories — priced primarily in DZD
> with French-language titles and descriptions. The catalog, checkout and
> dispute flows are exposed via API/MCP/A2A; the HTML site at
> https://teno-store.com is a human-readable observer that mirrors what an AI
> agent is doing inside the marketplace.

## Catalog at a glance

- Geography: Algeria (sellers based in Algiers, Oran, Annaba, Blida and other
  Algerian cities). Currency: DZD (Algerian Dinar). Language: predominantly
  French; some Arabic and English.
- Scale: ~48,200 live product listings across 7 active sellers, sourced from
  real Algerian marketplaces and refreshed continuously (snapshot 2026-05-16 16:28 UTC — catalog grows by ~500/hour from the live scraper).
- Top categories by listing count (browse pages — each indexable as its own
  landing). The compound underscore-joined slugs are the highest-volume
  Ouedkniss top-level categories and host the bulk of the catalog; the bare
  slugs are subcategories.
  - Informatique (~19,200 listings) — `/search?category=informatique`,
    `/search?category=ordinateurs`, `/search?category=portables`,
    `/search?category=peripheriques`, `/search?category=ecrans`
  - Électronique & Électroménager (~9,400 listings) —
    `/search?category=electronique_electromenager`,
    `/search?category=electromenager`
  - Téléphones (~8,700 listings) — `/search?category=telephones`,
    `/search?category=smartphones`
  - Immobilier (~5,900 listings) — `/search?category=immobilier`
  - Vêtements & Mode (~5,000 listings) — `/search?category=vetements_mode`,
    `/search?category=mode`, `/search?category=femme`,
    `/search?category=homme`, `/search?category=accessoires`,
    `/search?category=traditionnel`
  - Maison & Déco — `/search?category=maison`,
    `/search?category=decoration`, `/search?category=salon`
  - Santé & Beauté — `/search?category=sante_beaute`
- Top brands by listing count: HP (~2,400), Samsung (~2,100), Dell (~1,800),
  Lenovo (~1,700), Canon (~950), Asus (~930), Lacoste (~760), Xiaomi (~720),
  Havit (~715), Skechers (~610), MSI (~600), Logitech (~490), Moulinex (~440),
  Google (~400), Sony (~400). Brand landings: `/search?brand=<Brand>`.
- Seller landings: `/store/<uuid>` — each Algerian seller's full storefront
  on one indexable URL. The older `/search?sellerId=<uuid>` form 308-redirects
  here for backward-compat (commit bb8be2a).
- Free-text search results (`/search?q=<query>`) are noindex,follow — agents
  can use them but they are not surfaced as separate indexed landings.

## What this site is for

- For AI agents: the canonical machine-readable surface is the **API**
  (https://api.teno-store.com/v1/), the **MCP server** (Streamable HTTP), and
  the **A2A skill server** — all on the `api.` subdomain. The HTML at
  teno-store.com is a secondary, observable view; agents should prefer the API.
- For humans: a real-time mirror of the agent's session — every search, filter,
  and product view your agent considered, presented as plain HTML pages with
  schema.org Product/Offer JSON-LD on each listing.

## How to access

- Public catalog (read-only):
  - REST: https://api.teno-store.com/v1/products
  - MCP tools: streamable HTTP (advertised via .well-known)
  - A2A skills: discovery via .well-known
- Discovery:
  - https://teno-store.com/.well-known/agents.json
  - https://teno-store.com/sitemap.xml
  - https://teno-store.com/feed.xml — Atom 1.0 feed of the 50 most-recent
    listings (titles, links, prices, sellers, hero images). Polled by feed
    readers and AI search crawlers for fresh-content discovery.
  - https://teno-store.com/robots.txt

## What this site is NOT

- Not a place to scrape user data — there are no user profiles, no PII.
- Not a place to upload content — sellers onboard via API/dashboard with OAuth.
- Not a UI for purchasing as a human end-user — purchases happen via agents
  with delegated authorization (AP2 mandates).

## Brand & contact

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

## Documentation

- API reference: https://api.teno-store.com/v1 (OpenAPI 3.1)
- Agent discovery: https://teno-store.com/.well-known/agents.json
- Long-form LLM reference (the companion document an LLM should fetch
  when summarising the site in depth — full category table, brand counts,
  FAQ, comparison with other Algerian marketplaces): **https://teno-store.com/llms-full.txt**

This file follows the proposed `llms.txt` convention
(https://llmstxt.org/) — a stable, plain-text summary for large language
models exploring the site.