API & agents IA

Lisez DZ Ecommerce depuis vos logiciels ou agents IA : pages Markdown, API JSON, serveur MCP et flux. Aucune authentification requise.

Markdown for every page

Send an Accept header or append .md to any URL. Responses carry YAML front matter (canonical URL, language, dates, alternates) and an x-markdown-tokens header.

curl -H "Accept: text/markdown" https://dzecommerce.com/fr
curl https://dzecommerce.com/fr/index.md

JSON API

Read-only, unauthenticated, CORS-enabled. Paths in responses are site-relative.

GET https://dzecommerce.com/api/v1/articles?locale=fr&limit=10
GET https://dzecommerce.com/api/v1/search?locale=fr&q=delivery
GET https://dzecommerce.com/api/v1/articles/{locale}/{category}/{slug}
GET https://dzecommerce.com/api/v1/categories?locale=fr
GET https://dzecommerce.com/api/v1/companies?locale=fr&type=carrier
GET https://dzecommerce.com/api/v1/companies/{locale}/{slug}
GET https://dzecommerce.com/api/v1/authors/{locale}/{slug}

Full schema: /openapi.json

MCP server

Streamable HTTP endpoint, stateless, no authentication. Tools:

search_articles — Full-text search across published DZ Ecommerce news articles in Arabic, French or English. Returns titles, URLs, dates and excerpts.
get_article — Fetch one article (full Markdown body, authors, tags, companies, alternates) by URL or by locale + category + slug.
list_latest — List the most recent articles in a locale, optionally filtered by category, tag, author or company.
list_categories — List the editorial sections (ecommerce, shipping & logistics, marketplaces, payments, tools…) in a locale.
list_companies — List profiled companies (carriers, logistics, marketplaces, payment providers, tools) with type and profile URL.
get_company — Fetch a company profile (description, website, location, founding year, services, recent coverage).
get_author — Fetch a journalist profile (bio, job title, social profiles) and their latest articles.

{
  "mcpServers": {
    "dzecommerce": { "type": "http", "url": "https://dzecommerce.com/mcp" }
  }
}

Feeds

/ar/feed.xml · /ar/atom.xml · /ar/feed.json
/fr/feed.xml · /fr/atom.xml · /fr/feed.json
/en/feed.xml · /en/atom.xml · /en/feed.json

Discovery documents

llms.txt — LLM-friendly site overview (llmstxt.org)
llms-full.txt — Full Markdown of recent articles
OpenAPI 3.1 — Read-only JSON API description
API catalog (RFC 9727) — Linkset of public APIs
MCP server card — Streamable HTTP MCP server, no auth
Agent skills — SKILL.md guides for agents
ARD / ai-catalog — Agentic resource discovery manifest
auth.md — Authentication: none required
Web Bot Auth keys — Public keys our bots sign with
Sitemap — Sitemap index (+ /news-sitemap.xml)

Usage

Content Signals: search=yes, ai-input=yes, ai-train=yes. Please cite the canonical article URL and respect Retry-After on HTTP 429.