{"slug": "designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl", "title": "Designing an Agent-Accessible AI Tools Directory: Token-API, OpenAPI & Arabic RTL", "summary": "A developer built AI Tools List, a directory designed for both autonomous agents and human users, exposing /llms.txt, /llms-full.txt and /ai.json endpoints plus an OpenAPI 3.0.3-documented submission API at /api/agent/v1/tools/submit. The platform validates agent submissions with strict payload schemas and filters submitted URLs through private-IP and DNS-rebinding checks (UrlGuard) before fetching metadata, and treats Arabic as a first-class layout with logical CSS properties across eight locales. Benchmarking with SEOCheck-AI reported strong Core Web Vitals and long-lived cache and CSP headers.", "body_md": "As artificial intelligence ecosystems evolve beyond simple conversational interfaces into multi-agent systems, directories must transition from static visual catalogs into agent-accessible platforms.\n\nIn this article, we break down the architectural considerations behind building [AI Tools List](https://listaihub.com), focusing on machine-readable token APIs, OpenAPI specifications, Arabic-first RTL localization, and automated audit diagnostics.\n\nMost software directories are built exclusively for human browsing: bloated with third-party tracking scripts, paywalled rankings, and aggressive visual clutter. When an autonomous coding agent (such as Claude Code, AutoGPT, or LangChain agents) attempts to discover tools or submit a newly deployed open-source project, it encounters fragile DOM layouts and unstandardized submission forms.\n\nTo solve this, [AI Tools List](https://listaihub.com) was architected around three foundational principles:\n\n`/llms.txt`, `/llms-full.txt`, and `/ai.json` endpoints.\nRather than forcing developers or autonomous agents to fill out multi-step web forms, the platform exposes a developer submission endpoint documented at [https://listaihub.com/en/developers](https://listaihub.com/en/developers).\n\nThe agent interface enforces strict payload validation while safeguarding against SSRF and prompt injection:\n\n```\n{\n  \"openapi\": \"3.0.3\",\n  \"info\": {\n    \"title\": \"AI Tools List Agent API\",\n    \"version\": \"1.0.0\",\n    \"description\": \"Standardized programmatic submission and query interface for autonomous AI agents.\"\n  },\n  \"paths\": {\n    \"/api/agent/v1/tools/submit\": {\n      \"post\": {\n        \"summary\": \"Submit a new AI tool for editorial moderation\",\n        \"parameters\": [\n          {\n            \"name\": \"Authorization\",\n            \"in\": \"header\",\n            \"required\": true,\n            \"schema\": { \"type\": \"string\", \"example\": \"Bearer your-agent-token\" }\n          }\n        ],\n        \"requestBody\": {\n          \"required\": true,\n          \"content\": {\n            \"application/json\": {\n              \"schema\": {\n                \"type\": \"object\",\n                \"required\": [\"name\", \"url\", \"description\", \"pricing_model\"],\n                \"properties\": {\n                  \"name\": { \"type\": \"string\", \"maxLength\": 80 },\n                  \"url\": { \"type\": \"string\", \"format\": \"uri\" },\n                  \"description\": { \"type\": \"string\", \"maxLength\": 500 },\n                  \"pricing_model\": { \"type\": \"string\", \"enum\": [\"free\", \"freemium\", \"paid\", \"open-source\"] },\n                  \"primary_category\": { \"type\": \"string\" }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n```\n\nEvery incoming URL submitted via the API is resolved through strict private-IP and DNS rebinding filters (`UrlGuard`) before any metadata fetch occurs.\n\nA major differentiation in the frontend architecture is bidirectional layout parity. Arabic is treated not as an afterthought translation, but as an architectural peer:\n\n`margin-inline-start`, `padding-inline-end`, and `inset-inline` instead of rigid left/right rules.`ar`, `en`, `uk`, `pl`, `de`, `es`, `fr`, and `ru`.\nA directory is only as reliable as its delivery latency and indexability. To monitor Core Web Vitals, SSR hydration mismatch, and security transport compliance, we benchmarked the catalog using [SEOCheck-AI](https://seocheck-ai.com/free-seo-check).\n\nKey baseline results:\n\n`max-age=63072000`) and comprehensive Content-Security-Policy headers.\nThe future of software catalogs belongs to systems that treat autonomous agents and human developers as equal citizens.\n\nTo explore the catalog, test the developer API, or inspect the OpenAPI spec:", "url": "https://wpnews.pro/news/designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl", "canonical_source": "https://dev.to/romangrid/designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl-15g", "published_at": "2026-10-31 19:40:13+00:00", "updated_at": "2026-10-31 19:52:11.981392+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "ai-crawlers", "developer-tools"], "entities": ["AI Tools List", "SEOCheck-AI", "Claude Code", "AutoGPT", "LangChain"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl", "markdown": "https://wpnews.pro/news/designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl.md", "text": "https://wpnews.pro/news/designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl.txt", "jsonld": "https://wpnews.pro/news/designing-an-agent-accessible-ai-tools-directory-token-api-openapi-arabic-rtl.jsonld"}}