AI Directories
ทางการค้นหาในแคตตาล็อก AI Directories ดูรายการ และเรียกดูไดเรกทอรีการส่งผลงาน
คุณทำอะไรได้บ้างด้วย AI Directories MCP?
- ค้นหาเครื่องมือ AI — สอบถามเพื่อค้นหาเครื่องมือ AI ด้วยคำสำคัญ หมวดหมู่ แท็ก หรือราคาโดยใช้
search_tools - ดึงรายละเอียดเครื่องมือ — ขอรายการสาธารณะฉบับเต็มสำหรับเครื่องมือใดๆ ผ่าน slug ด้วย
get_toolรวมถึงภาพหน้าจอและคำถามที่พบบ่อย - เรียกดูเครื่องมือยอดนิยม — สอบถามเครื่องมือ AI ที่ได้รับความนิยมสูงสุดตามจำนวนการเปิดใช้ โดยสามารถกรองตามหมวดหมู่ได้ด้วย
get_top_tools - สำรวจหมวดหมู่และแท็ก — ให้ผู้ช่วยแสดงรายการหมวดหมู่หรือแท็กเครื่องมือ AI ทั้งหมดพร้อมจำนวนด้วย
list_categoriesหรือlist_tags - ค้นหาไดเรกทอรีสำหรับส่งผลงาน — ค้นหาไดเรกทอรีตามชื่อ ค่าใช้จ่าย หรือหมวดหมู่ด้วย
search_directoriesเพื่อระบุเป้าหมายในการส่งผลงาน - รับโปรไฟล์ไดเรกทอรี — ดึงโปรไฟล์ฉบับเต็มของไดเรกทอรี รวมถึง Domain Rating และข้อกำหนดของป้ายรับรอง ผ่าน
get_directory
เอกสาร
นักพัฒนา
API และ MCP
แคตตาล็อก AI Directories อย่างเป็นทางการ — ค้นหาเครื่องมือ AI และไดเรกทอรีการส่งรายการจาก curl หรือเอเจนต์ ฟรี มีเอกสารครบถ้วน และดีกว่าการขูดข้อมูล
RESTGET · Bearer aid_
MCPStreamable HTTP
OpenAPImachine spec
ค้นหาแคตตาล็อก AI Directories ดูรายการ และเรียกดูไดเรกทอรีการส่งรายการ — จากเอเจนต์หรือจาก curl REST และ MCP ใช้แบ็กเอนด์เดียวกัน บุคคลที่สามที่ขูดข้อมูลจะครอบคลุมหน้าสาธารณะของเราและเรียกเก็บเงินสำหรับข้อมูลที่ส่งออก นี่คือแหล่งข้อมูลอย่างเป็นทางการ
ตัวอย่าง — GET /tools/transclipper
curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
-H "Authorization: Bearer aid_your_api_key"
{
"success": true,
"data": {
"id": "69b81f3e40816562014e004a",
"slug": "transclipper",
"name": "TransClipper",
"url": "https://www.aidirectori.es/ai-tools/transclipper",
"website": "https://transclipper.ai",
"tagline": "Steal the Blueprint Behind Any Viral Video",
"description": "TransClipper is a powerful AI-driven tool designed for efficient content clipping and transcription.",
"category": { "slug": "video", "name": "Video" },
"tags": [
{ "slug": "ai", "name": "AI" },
{ "slug": "content-creation", "name": "Content Creation" }
],
"pricing": "FREE",
"rating": 4,
"opens": 4030,
"featured": true,
"icon": "https://cdn.aidirectori.es/icons/1784893027853-vpj1hwsqkq.png"
}
}
สิ่งที่คุณทำได้
- ค้นหาเครื่องมือ AI ด้วยคำสำคัญ หมวดหมู่ แท็ก หรือราคา
- ดึงเครื่องมือหนึ่งรายการด้วย slug (รายการสาธารณะแบบเต็ม)
- แสดงรายการหมวดหมู่และแท็ก
- ค้นหาไดเรกทอรีการส่งรายการ (DR, ค่าใช้จ่าย, ป้าย)
- ดึงโปรไฟล์ไดเรกทอรีหนึ่งรายการด้วยคีย์ aid_ ของคุณ
สิ่งที่คุณทำไม่ได้
- อ่านอีเมลผู้ก่อตั้งหรือข้อมูลวิเคราะห์ส่วนตัว
- ขูดข้อมูลเว็บไซต์ HTML หรือแอบอ้างเป็นครอว์เลอร์
- เผยแพร่แคตตาล็อกซ้ำเป็นไดเรกทอรีคู่แข่ง
- เรียกใช้ API การเขียนของพันธมิตรโดยไม่มีคีย์ที่ออกให้
เหตุผลที่มีสิ่งนี้
ผู้คนขูดข้อมูล aidirectori.es และขายข้อมูลที่ส่งออก API อย่างเป็นทางการฟรีสำหรับผลิตภัณฑ์ งานวิจัย และเอเจนต์ — พร้อมการระบุแหล่งที่มา ขีดจำกัดอัตรา และใบอนุญาต: คุณไม่สามารถเผยแพร่แคตตาล็อกทั้งหมดซ้ำเป็นไดเรกทอรีคู่แข่งหรือการขูดข้อมูลแบบเสียเงิน
ใส่ในเอเจนต์
Cursor: .cursor/mcp.json หรือ ~/.cursor/mcp.json. ไม่มีช่องว่างหลัง Authorization: — mcp-remote แยกตามช่องว่าง ดู ติดตั้ง MCP
{
"mcpServers": {
"aidirectories": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://www.aidirectori.es/api/mcp",
"--header", "Authorization:Bearer aid_your_real_key"
]
}
}
}
ยังอ่านด้วยเครื่องได้
- /llms.txt — ข้อมูลย่อของเว็บไซต์สำหรับเอเจนต์
- /sitemap.xml
- 60 คำขอ/นาที · 400/ชั่วโมง ต่อ IP
เริ่มต้นใช้งาน / Quickstart
Quickstart
สร้างคีย์ aid_ จากนั้นค้นหาเครื่องมือ ดึงรายการหนึ่งรายการ และค้นหาไดเรกทอรี
สร้างคีย์บน แดชบอร์ดนักพัฒนา จากนั้นคัดลอกสิ่งเหล่านี้
1. ค้นหาเครื่องมือ AI
curl -s "https://www.aidirectori.es/api/v1/tools?q=image&limit=5" \
-H "Authorization: Bearer aid_your_api_key"
2. ดึงรายการหนึ่งรายการ
curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
-H "Authorization: Bearer aid_your_api_key"
3. ค้นหาไดเรกทอรี
curl -s "https://www.aidirectori.es/api/v1/directories?q=ai&limit=5" \
-H "Authorization: Bearer aid_your_api_key"
การดำเนินการเดียวกันผ่าน MCP: เพิ่มเซิร์ฟเวอร์ด้วยโทเค็น Bearer เดียวกัน จากนั้นเรียก search_tools, get_tool และ search_directories ดู การติดตั้ง MCP
เริ่มต้นใช้งาน / การรับรองความถูกต้อง
การรับรองความถูกต้อง
โทเค็น Bearer ผ่านคีย์ API สร้างคีย์จากแดชบอร์ดนักพัฒนาของคุณ มาตรฐาน 10/นาที พรีเมียม 60/นาที
การรับรองความถูกต้อง
โทเค็น Bearer ผ่านคีย์ API สร้างคีย์จาก แดชบอร์ดนักพัฒนา ของคุณ
ขีดจำกัดอัตรา
คีย์มาตรฐานได้รับ 10 คำขอต่อนาที คีย์พรีเมียมได้รับ 60 อัปเกรดจาก แดชบอร์ดนักพัฒนา ของคุณ ส่วนหัวขีดจำกัดอัตราอยู่ในทุกการตอบกลับ
URL ฐาน
https://www.aidirectori.es/api/v1
-
1 รับคีย์ API ของคุณ
ไปที่ แดชบอร์ดนักพัฒนา และสร้างคีย์ API คีย์เริ่มต้นด้วยaid_เก็บไว้อย่างปลอดภัย — คุณจะไม่สามารถเห็นคีย์เต็มได้อีก ต้องยอมรับการใช้งานที่เหมาะสม การสร้างคีย์ต้องยอมรับ นโยบายการใช้งานที่เหมาะสมของ API การโคลนธุรกิจ การสร้าง AI Directories ใหม่ การเผยแพร่ซ้ำเป็นจำนวนมาก หน้า SEO สาธารณะที่ไม่ได้รับอนุญาต การกำหนดเป้าหมายที่ไม่เหมาะสม การแชร์ข้อมูลรับรอง และการหลีกเลี่ยงการควบคุมการเข้าถึงเป็นสิ่งต้องห้ามและอาจส่งผลให้ถูกแบนจากแพลตฟอร์มถาวร -
2 ทำคำขอแรกของคุณ
ส่งคีย์ของคุณเป็นโทเค็น Bearer ในส่วนหัวAuthorizationX-API-Keyก็ยอมรับเช่นกัน ในทุกเอนด์พอยต์ ทั้งสองใช้แทนกันได้ — สิ่งที่คีย์เข้าถึงได้ขึ้นอยู่กับคีย์ ไม่ใช่ส่วนหัวที่ส่งมา คีย์aid_ของแดชบอร์ดยังได้รับ403บนเอนด์พอยต์พันธมิตรเมื่อส่งเป็นX-API-Key; หากคุณเห็น 403 คุณต้องใช้คีย์อื่น ไม่ใช่ส่วนหัวอื่นcurl -s "https://www.aidirectori.es/api/v1/tools?q=ai&limit=5" \ -H "Authorization: Bearer aid_your_api_key" -
3 แยกวิเคราะห์การตอบกลับ
การอ่านที่สำเร็จจะส่งคืน{ success: true, data }เอนด์พอยต์รายการยังรวมpagination— ฟิลด์และกฎการจำกัด ของมันควรอ่านก่อนเขียนลูปการแบ่งหน้า ดูX-RateLimit-Remaining{ "success": true, "data": [ { "slug": "transclipper", "name": "TransClipper", "website": "https://transclipper.ai" } ] }
คีย์พันธมิตร
พันธมิตรไดเรกทอรีที่ส่งเครื่องมือให้เราสำหรับบริการส่งรายการยังใช้คีย์ที่ออกให้สำหรับ POST /submit-ai-tool, สถานะ, เว็บฮุค และการสนับสนุน คีย์เหล่านั้นยังทำงานกับการอ่านแคตตาล็อก ดู มีไดเรกทอรีหรือไม่?
MCP / การติดตั้ง
ติดตั้ง MCP
MCP Streamable HTTP ที่โฮสต์ — ส่งคีย์ Bearer เดียวกับ REST
เซิร์ฟเวอร์พูดโปรโตคอล Model Context Protocol ผ่าน Streamable HTTP มันถูกโฮสต์ ทุกเครื่องมือครอบคลุมฟังก์ชันเดียวกันกับ REST API ส่ง Authorization: Bearer aid_… จาก แดชบอร์ดนักพัฒนา ของคุณ
https://www.aidirectori.es/api/mcp
Claude Code
claude mcp add --transport http aidirectories https://www.aidirectori.es/api/mcp \
--header "Authorization: Bearer aid_your_api_key"
Cursor / Claude Desktop
ขอบเขตโปรเจกต์: .cursor/mcp.json ทั่วโลก: ~/.cursor/mcp.json Claude Desktop: claude_desktop_config.json (stdio เท่านั้น — บล็อกเดียวกันนี้)
{
"mcpServers": {
"aidirectories": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://www.aidirectori.es/api/mcp",
"--header", "Authorization:Bearer aid_your_real_key"
]
}
}
}
ไม่มีช่องว่างหลัง Authorization: — mcp-remote แยกอาร์กิวเมนต์ตามช่องว่าง ดังนั้น "Authorization: Bearer …" จะทำลายส่วนหัว รีสตาร์ทไคลเอนต์ทั้งหมดหลังแก้ไขไฟล์
หลังจากเพิ่มเซิร์ฟเวอร์ ให้ขอให้เอเจนต์แสดงรายการเครื่องมือ คุณควรเห็น search_tools, get_top_tools, get_tool, list_categories, list_tags, search_directories, get_directory และ list_directory_categories
ตรวจสอบ
curl -s https://www.aidirectori.es/api/mcp -X POST \
-H "Authorization: Bearer aid_your_api_key" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
MCP / เครื่องมือ
เครื่องมือ MCP
ทุกเครื่องมือ MCP เป็นตัวครอบบางๆ เหนือแคตตาล็อก REST
การรับรองความถูกต้องคือคีย์ Bearer aid_ เดียวกับ REST
| เครื่องมือ | REST | ข้อมูลนำเข้า |
|---|---|---|
search_tools | GET /tools | q, category, tag, pricing, featured, page, limit |
get_top_tools | GET /tools/top | limit, category |
get_tool | GET /tools/{slug} | slug |
list_categories | GET /categories | q, limit |
list_tags | GET /tags | q, limit |
search_directories | GET /directories | q, category, cost, featured, page, limit |
get_directory | GET /directories/{slug} | slug |
list_directory_categories | GET /directory-categories | — |
บันทึกฟิลด์เต็มอยู่ภายใต้ เครื่องมือ AI และ ไดเรกทอรี
REST API / ภาพรวม
REST API
HTTP ธรรมดาสำหรับสคริปต์ CI และการรวมพันธมิตร เซิร์ฟเวอร์ MCP เรียกเส้นทางเดียวกันเหล่านี้ — ดังนั้นผลลัพธ์ไม่เคยขึ้นอยู่กับว่าการขนส่งใดขอ
| การดำเนินการ | เมธอด | เส้นทาง | การรับรองความถูกต้อง | ข้อมูลนำเข้า |
|---|---|---|---|---|
| search_tools ค้นหาคำสำคัญพร้อมตัวกรองหมวดหมู่ แท็ก ราคา และรายการเด่นเพิ่มเติม | GET | /tools | Bearer | q, category, tag, pricing, featured, includeAdult, page, limit |
| get_top_tools รายการ N อันดับแรกโดยการเปิด — ไม่ต้องใช้คำสำคัญ | GET | /tools/top | Bearer | limit, category, includeAdult |
| list_categories หมวดหมู่เครื่องมือ AI พร้อมจำนวนเครื่องมือ — ใช้ก่อนกรองการค้นหา | GET | /categories | Bearer | q, limit |
| list_tags แท็กเครื่องมือ AI พร้อมจำนวนเครื่องมือ | GET | /tags | Bearer | q, limit |
| get_tool รายการสาธารณะเต็มสำหรับเครื่องมือ AI หนึ่งรายการ | GET | /tools/{slug} | Bearer | slug |
| search_directories ค้นหาไดเรกทอรีการส่งรายการตามชื่อ หมวดหมู่ หรือค่าใช้จ่าย | GET | /directories | Bearer | q, category, cost, featured, page, limit |
| get_directory โปรไฟล์สาธารณะเต็มสำหรับไดเรกทอรีหนึ่งรายการ | GET | /directories/{slug} | Bearer | slug |
| list_directory_categories ป้ายหมวดหมู่ไดเรกทอรีสำหรับการค้นพบตัวกรอง | GET | /directory-categories | Bearer | — |
| submit_ai_tool สร้างรายการเครื่องมือ AI (และเลือกจัดคิวการส่งไดเรกทอรี) | POST | /submit-ai-tool | X-API-Key | name, website, tagline, description, category, pricing, founderName, founderEmail, tags, paymentType, … |
| get_tool_status ตรวจสอบความคืบหน้าการส่งไดเรกทอรีสำหรับเครื่องมือที่คีย์ของคุณส่ง | GET | /ai-tools/status | X-API-Key | id | slug | website |
การค้นพบอยู่ที่ GET / และเอกสาร OpenAPI ที่ GET /openapi.json บันทึกฟิลด์สำหรับการตอบกลับแคตตาล็อกอยู่ที่ เครื่องมือ AI และ ไดเรกทอรี
ซองจดหมาย การแบ่งหน้า และขีดจำกัด
ทุกการตอบกลับเป็นซองจดหมายเดียวกัน data เป็นอาร์เรย์ในการค้นหาและเป็นออบเจกต์ในการค้นหารายการเดียว ตรวจสอบ success ก่อนอ่าน data
{ "success": true, "data": [], "pagination": { "page": 1, "limit": 20, "total": 0, "pages": 0 } }
{ "success": false, "error": "Invalid or revoked API key." }
GET /tools และ GET /directories ส่งคืนออบเจกต์ pagination เอนด์พอยต์อนุกรมวิธาน — /categories, /tags, /directory-categories — ส่งคืนรายการทั้งหมดและไม่มีคีย์ pagination เลย
| page | หน้าที่คุณได้รับ เริ่มที่ 1 |
|---|---|
| limit | รายการต่อหน้าที่ใช้จริง |
| total | รายการที่ตรงกันทั้งหมดทุกหน้า |
| pages | ceil(total / limit) หรือ 0 เมื่อไม่มีรายการตรงกัน |
ขีดจำกัดที่ใหญ่เกินไปถูกจำกัด ไม่ถูกปฏิเสธ ขอมากกว่าสูงสุดและคุณได้รับสูงสุด พร้อม 200 — ไม่มีข้อผิดพลาดบอกคุณว่าเกิดขึ้น /tools และ /directories ค่าเริ่มต้นที่ 20 และจำกัดที่ 100; /categories และ /tags จำกัดที่ 500 limit ที่หายไป เป็นศูนย์ ติดลบ หรือไม่ใช่ตัวเลขจะกลับไปใช้ค่าเริ่มต้น และ page พื้นที่ที่ 1 ดังนั้นอ่าน pagination.limit กลับจากการตอบกลับแทนการสมมติว่าคุณได้ขนาดหน้าที่ขอ — สมมติฐานนั้นคือสิ่งที่เปลี่ยนลูปการแบ่งหน้าเป็นลูปไม่มีที่สิ้นสุด
page=1
while :; do
body=$(curl -s "https://www.aidirectori.es/api/v1/tools?limit=100&page=$page" \
-H "Authorization: Bearer $AID_KEY")
echo "$body" | jq -e '.success' >/dev/null || { echo "$body"; break; }
echo "$body" | jq -c '.data[]'
pages=$(echo "$body" | jq '.pagination.pages')
[ "$page" -ge "$pages" ] && break
page=$((page + 1))
sleep 6 # stay under 10 req/min on a standard key
done
เครื่องมือ AI
เรียกดู ค้นหา และกรองแคตตาล็อกสด หรือดึงรายการหนึ่งรายการด้วย slug แมปกับ MCP search_tools, get_top_tools, get_tool, list_categories และ list_tags
list_categories
หมวดหมู่เครื่องมือ AI พร้อมจำนวนเครื่องมือ — ใช้ก่อนกรองการค้นหา
| REST | GET /categories |
|---|---|
| MCP | tools/call → list_categories |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | q, limit |
curl -s "https://www.aidirectori.es/api/v1/categories" \
-H "Authorization: Bearer aid_your_api_key"
get_top_tools
รายการ N อันดับแรกโดยการเปิด — ไม่ต้องใช้คำสำคัญ
| REST | GET /tools/top |
|---|---|
| MCP | tools/call → get_top_tools |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | limit, category, includeAdult |
curl -s "https://www.aidirectori.es/api/v1/tools/top?limit=10&category=image" \
-H "Authorization: Bearer aid_your_api_key"
search_tools
ค้นหาคำสำคัญพร้อมตัวกรองหมวดหมู่ แท็ก ราคา และรายการเด่นเพิ่มเติม
| REST | GET /tools |
|---|---|
| MCP | tools/call → search_tools |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | q, category, tag, pricing, featured, includeAdult, page, limit |
curl -s "https://www.aidirectori.es/api/v1/tools?q=ai&limit=5" \
-H "Authorization: Bearer aid_your_api_key"
get_tool
รายการสาธารณะเต็มสำหรับเครื่องมือ AI หนึ่งรายการ
| REST | GET /tools/{slug} |
|---|---|
| MCP | tools/call → get_tool |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | slug |
curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
-H "Authorization: Bearer aid_your_api_key"
list_tags
แท็กเครื่องมือ AI พร้อมจำนวนเครื่องมือ
| REST | GET /tags |
|---|---|
| MCP | tools/call → list_tags |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | q, limit |
curl -s "https://www.aidirectori.es/api/v1/tags" \
-H "Authorization: Bearer aid_your_api_key"
ไดเรกทอรี
แคตตาล็อกไดเรกทอรีการส่งรายการ — Domain Rating, ค่าใช้จ่าย, ป้าย และหมวดหมู่ แมปกับ MCP search_directories, get_directory และ list_directory_categories
search_directories
ค้นหาไดเรกทอรีการส่งรายการตามชื่อ หมวดหมู่ หรือค่าใช้จ่าย
| REST | GET /directories |
|---|---|
| MCP | tools/call → search_directories |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | q, category, cost, featured, page, limit |
curl -s "https://www.aidirectori.es/api/v1/directories?cost=Free&limit=10" \
-H "Authorization: Bearer aid_your_api_key"
get_directory
โปรไฟล์สาธารณะเต็มสำหรับไดเรกทอรีหนึ่งรายการ
| REST | GET /directories/{slug} |
|---|---|
| MCP | tools/call → get_directory |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | slug |
curl -s "https://www.aidirectori.es/api/v1/directories/theres-an-ai-for-that" \
-H "Authorization: Bearer aid_your_api_key"
list_directory_categories
ป้ายหมวดหมู่ไดเรกทอรีสำหรับการค้นพบตัวกรอง
| REST | GET /directory-categories |
|---|---|
| MCP | tools/call → list_directory_categories |
| การรับรองความถูกต้อง | Bearer |
| ข้อมูลนำเข้า | — |
curl -s "https://www.aidirectori.es/api/v1/directory-categories" \
-H "Authorization: Bearer aid_your_api_key"
พันธมิตร
เอนด์พอยต์การเขียนและสถานะต้องการ X-API-Key ที่ออกให้ เก็บไว้บนเซิร์ฟเวอร์ของคุณ MCP ไม่เรียกสิ่งเหล่านี้ รายการฟิลด์เต็มอยู่ภายใต้ ส่งและพันธมิตร
submit_ai_tool
สร้างรายการเครื่องมือ AI (และเลือกจัดคิวการส่งไดเรกทอรี)
| REST | POST /submit-ai-tool |
|---|---|
| MCP | — |
| Auth | X-API-Key |
| Input | name, website, tagline, description, category, pricing, founderName, founderEmail, tags, paymentType, … |
curl -s -X POST "https://www.aidirectori.es/api/v1/submit-ai-tool" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Tool",
"website": "https://mytool.com",
"tagline": "One-line pitch",
"description": "What the product does.",
"category": "productivity",
"pricing": "FREE",
"paymentType": "pro",
"founderName": "Jane Founder",
"founderEmail": "jane@mytool.com",
"tags": ["ai", "productivity"],
"icon": "https://mytool.com/icon.png",
"frame": "https://mytool.com/screenshot.png",
"screenshots": ["https://mytool.com/gallery-1.png"]
}'
get_tool_status
ตรวจสอบความคืบหน้าของการส่งรายการในไดเรกทอรีสำหรับเครื่องมือที่คีย์ของคุณส่งไป
| REST | GET /ai-tools/status |
|---|---|
| MCP | — |
| Auth | X-API-Key |
| Input | id | slug | website |
curl -s "https://www.aidirectori.es/api/v1/ai-tools/status?slug=my-ai-tool" \
-H "X-API-Key: YOUR_API_KEY"
REST API / เครื่องมือ AI
เครื่องมือ AI
เรียกดู ค้นหา และดึงรายการเครื่องมือ AI ที่เผยแพร่แล้ว
search_tools
ค้นหาด้วยคำสำคัญ พร้อมตัวกรองหมวดหมู่ แท็ก ราคา และรายการแนะนำ
| REST | GET /tools |
|---|---|
| MCP | search_tools |
| Auth | Bearer aid_ |
| Input | q, category, tag, pricing (FREE | FREEMIUM | PAID), featured, includeAdult, page, limit (สูงสุด 100) |
curl -s "https://www.aidirectori.es/api/v1/tools?q=transclipper&limit=5" \
-H "Authorization: Bearer aid_your_api_key"
แต่ละรายการประกอบด้วยชื่อ slug URL รายการ เว็บไซต์ คำโปรย คำอธิบาย หมวดหมู่ แท็ก ราคา คะแนน จำนวนการเปิด ไอคอน และการประทับเวลา ไม่มีอีเมลผู้ก่อตั้ง
รายการสำหรับผู้ใหญ่จะถูกแยกออกโดยค่าเริ่มต้น search_tools และ get_top_tools กันรายการสำหรับผู้ใหญ่ไว้ เว้นแต่คุณจะขออย่างชัดเจน
การแยกออกเป็นไปตามหมวดหมู่และแท็ก เนื่องจากเครื่องมือสำหรับผู้ใหญ่มักถูกจัดอยู่ในหมวดหมู่ทั่วไป เช่น image, writing, video — ขณะที่แท็กของพวกมันระบุตัวตนได้แม่นยำกว่า ดังนั้น category=image จึงคืนเครื่องมือรูปภาพโดยไม่มีแอปถอดเสื้อผ้า
สามวิธีในการเลือกดู: includeAdult=true, category=nsfw, หรือระบุแท็กสำหรับผู้ใหญ่ เช่น tag=ai-undressing ไม่มีอะไรถูกซ่อนหรือเข้าถึงไม่ได้ — เพียงแต่คุณจะไม่เห็นมันเมื่อคุณไม่ได้ขอ
get_top_tools
เครื่องมือที่เผยแพร่แล้วซึ่งถูกเปิดมากที่สุด มี slug หมวดหมู่ให้เลือก
curl -s "https://www.aidirectori.es/api/v1/tools/top?limit=10&category=image" \
-H "Authorization: Bearer aid_your_api_key"
get_tool
รายการสาธารณะแบบเต็ม: ภาพหน้าจอ คำถามที่พบบ่อย โซเชียล ฟีเจอร์
curl -s "https://www.aidirectori.es/api/v1/tools/transclipper" \
-H "Authorization: Bearer aid_your_api_key"
list_categories / list_tags
curl -s "https://www.aidirectori.es/api/v1/categories" -H "Authorization: Bearer aid_your_api_key"
curl -s "https://www.aidirectori.es/api/v1/tags?q=photo" -H "Authorization: Bearer aid_your_api_key"
หมวดหมู่คืนค่า slug, name, description, icon, toolsCount แท็กคืนค่า slug, name, toolsCount ไม่มีการแบ่งหน้า — คุณได้รับทั้งรายการ ดังนั้นแคชไว้และกรองในเครื่อง
ฟิลด์ของเครื่องมือ
คืนค่าโดย /tools, /tools/top และ /tools/{slug} เช่นเดียวกัน:
| ฟิลด์ | ชนิด | หมายเหตุ |
|---|---|---|
id | string | ตัวระบุที่เสถียร |
slug | string | ใช้ค่านี้สำหรับ /tools/{slug} |
name, tagline, description | string | |
url | string | รายการบน aidirectori.es |
website | string | เว็บไซต์ของผลิตภัณฑ์เอง |
category | object | { slug, name }, หรือ null |
tags | array | [{ slug, name }] |
pricing | string | FREE | FREEMIUM | PAID |
rating | number | 0 เมื่อไม่มีการให้คะแนน |
opens | number | จำนวนคลิกผ่าน; สิ่งที่ /tools/top ใช้จัดเรียง |
featured | boolean | |
icon, frame | string | URL รูปภาพ, เป็นค่าว่างได้ |
founderName, location | string | เป็นค่าว่างได้ ไม่มีอีเมลผู้ก่อตั้งเด็ดขาด |
domainRating | number | เป็นค่าว่างได้ |
isForSale, askingPrice | boolean, number | รายการที่ทำเครื่องหมายสำหรับการซื้อกิจการ |
discountCode, affiliate | string, boolean | |
createdAt, updatedAt | string | ISO 8601, เป็นค่าว่างได้ |
GET /tools/{slug} เพิ่ม screenshots (อาร์เรย์ของ URL), video, socials, faqs, features, และ affiliateLink หกฟิลด์นี้มีเฉพาะในเอนด์พอยต์เครื่องมือเดี่ยว — อย่าคาดหวังจากผลการค้นหา
ฟิลด์ใดก็ได้สามารถเป็น null เมื่อรายการยังไม่ได้กรอกข้อมูล เขียนโค้ดแบบป้องกันไว้เสมอ
REST API / ไดเรกทอรี
ไดเรกทอรี
อีกครึ่งหนึ่งของแคตตาล็อก — ไดเรกทอรีสำหรับส่งรายการสตาร์ทอัพและ SaaS พร้อม DR และราคา
สคริปเตอร์มักพลาดส่วนนี้ นี่คือรายการที่เราใช้ส่งผลิตภัณฑ์จริง
search_directories
| REST | GET /directories |
|---|---|
| MCP | search_directories |
| Auth | Bearer aid_ |
| Input | q, category, cost (Free | Paid | Freemium), featured, page, limit |
curl -s "https://www.aidirectori.es/api/v1/directories?cost=Free&limit=10" \
-H "Authorization: Bearer aid_your_api_key"
ฟิลด์ประกอบด้วยชื่อ URL รายการ เว็บไซต์ Domain Rating จำนวนผู้เยี่ยมชมรายเดือน ชนิดลิงก์ ข้อกำหนดป้าย สัญญาณราคาขั้นต่ำ และหมวดหมู่
get_directory
เพิ่มคำอธิบาย คำถามที่พบบ่อย ลิงก์ส่งรายการ และข้อความดีล
curl -s "https://www.aidirectori.es/api/v1/directories/theres-an-ai-for-that" \
-H "Authorization: Bearer aid_your_api_key"
list_directory_categories
curl -s "https://www.aidirectori.es/api/v1/directory-categories" \
-H "Authorization: Bearer aid_your_api_key"
คืนค่า slug และ name เท่านั้น ไม่มีการแบ่งหน้า ค่าเหล่านี้คือค่าที่ ?category= ยอมรับ — อ่านค่าเหล่านี้แทนการเดา
ฟิลด์ของไดเรกทอรี
| ฟิลด์ | ชนิด | หมายเหตุ |
|---|---|---|
id, slug, name | string | |
url | string | โปรไฟล์บน aidirectori.es |
website | string | เว็บไซต์ของไดเรกทอรีเอง |
icon | string | เป็นค่าว่างได้ |
cost | string | Free | Paid | Freemium |
type | string | ชนิดลิงก์ |
domainRating | number | เป็นค่าว่างได้ — ตัวเลขที่คนส่วนใหญ่ใช้จัดเรียง |
monthlyVisits | number | เป็นค่าว่างได้ |
requiresBadge | boolean | ว่าพวกเขาต้องการป้ายลิงก์ย้อนกลับหรือไม่ |
minimumPrice | number | 0 เมื่อฟรี |
submissionExperience | string | เป็นค่าว่างได้ |
featured | boolean | |
categories | array | [{ slug, name }] |
smallDescription | string | เป็นค่าว่างได้ |
createdAt, updatedAt | string | ISO 8601 |
GET /directories/{slug} เพิ่ม fullDescription, features, useCases, faq, deal ({ text, code } หรือ null), frame, และ socials
สังเกตฟิลด์ url สองฟิลด์: url คือหน้าของเรา ส่วน website คือไดเรกทอรีเอง URL ฟอร์มส่งโดยตรง (submissionLink) ไม่อยู่ใน API แคตตาล็อกหรือ MCP — เป็นส่วนหนึ่งของผลิตภัณฑ์รายการแบบชำระเงินบนเว็บไซต์และแดชบอร์ด
การเลือกเป้าหมายการส่ง
curl -s "https://www.aidirectori.es/api/v1/directories?cost=Free&limit=100" \
-H "Authorization: Bearer $AID_KEY" \
| jq -r '.data
| map(select(.requiresBadge == false and .domainRating != null))
| sort_by(-.domainRating)
| .[]
| [.domainRating, .name, .website] | @tsv'
ฟรี ไม่ต้องมีป้าย โดเมนที่แข็งแกร่งที่สุดก่อน
REST API / ส่งและพันธมิตร
ส่งและพันธมิตร
เอนด์พอยต์สำหรับคีย์ API ในการส่งเครื่องมือ ตรวจสอบสถานะ เว็บฮุค และการสนับสนุน
สิ่งเหล่านี้ไม่ไม่ระบุชื่อ เราออกคีย์ให้พันธมิตรแต่ละราย MCP ไม่เรียกใช้สิ่งเหล่านี้
ส่งเครื่องมือ
POST https://www.aidirectori.es/api/v1/submit-ai-tool
สร้างรายการ ส่ง paymentType เพื่อจัดคิวการส่งไดเรกทอรีสำหรับแพ็กเกจนั้น ละเว้นค่านี้และเครื่องมือจะถูกสร้างเป็นสถานะรอ เพื่อให้ตั้งค่าแพ็กเกจได้ในภายหลังในแอดมิน
จำเป็น
9
การขาดฟิลด์ใดฟิลด์หนึ่งจะคืนค่า 400
ฟิลด์ชนิดหมายเหตุ
namestring สูงสุด 100 ตัวอักษรwebsiteurl URL สาธารณะของผลิตภัณฑ์taglinestring สูงสุด 200 ตัวอักษรdescriptionstring สิ่งที่ผลิตภัณฑ์ทำcategorystring Slug หรือชื่อ เราจับคู่กับหมวดหมู่ที่มีอยู่pricingenumFREEPAIDFREEMIUMราคาของผลิตภัณฑ์เอง — ไม่ใช่แพ็กเกจไดเรกทอรีfounderNamestring คุณเก็บค่านี้ก่อน POSTfounderEmailemail คุณเก็บค่านี้ ไม่ถูกคืนในการอ่านแคตตาล็อกสาธารณะ อย่าส่งจากเบราว์เซอร์tagsstring[] Slug หรือชื่อ
แนะนำ
5
คำขอสำเร็จได้โดยไม่ต้องมีฟิลด์เหล่านี้ — เราสร้าง slug ดึงไอคอน/og:image และปล่อยแพ็กเกจเป็นสถานะรอ ส่งเมื่อคุณมี
ฟิลด์ชนิดหมายเหตุ
paymentTypeenumstarterpropremiumแพ็กเกจไดเรกทอรี: 30+, 60+, หรือ 100+ การส่ง ส่งค่านี้หากลูกค้าเลือกแพ็กเกจแล้ว ละเว้นเฉพาะเมื่อคุณต้องการให้เครื่องมือถูกสร้างเป็นสถานะรอเพื่อให้แอดมินตั้งค่าในภายหลังslugstring Slug URL สาธารณะ สร้างจากชื่อ (และทำให้ไม่ซ้ำ) หากละเว้น — ส่งเมื่อคุณมี slug ที่เสถียรอยู่แล้วiconurl โลโก้สี่เหลี่ยม หากละเว้น เราดึง favicon ของเว็บไซต์ — ส่งโลโก้ของคุณเองเพื่อรายการที่ดีกว่าframeurl ภาพหน้าจอหลัก หากละเว้น เราดึง og:image — ส่งภาพผลิตภัณฑ์เมื่อคุณมีscreenshotsurl[] ภาพแกลเลอรี กระจายไปยัง Cloudflare ไม่จำเป็น; เฟรมครอบคลุมภาพหลักหากค่าว่าง
ไม่บังคับ
11
ภาพที่ URL สาธารณะจะถูกกระจายไปยัง Cloudflare
ฟิลด์ชนิดหมายเหตุ
videourl YouTube หรือ Vimeosocialsobject คีย์ไปยัง URL เช่น{ "twitter": "https://x.com/…" }featuresobject แผนที่สตริง เช่น{ "Templates": "50+" }สร้างขึ้นหากละเว้นfaqarray หากละเว้น ถูกดึงจากเว็บไซต์หรือสร้างขึ้นaffiliatestring ข้อความโปรแกรมพันธมิตรaffiliateLinkurldiscountCodestring รหัสโปรโมชันที่แสดงบนรายการlocationstring ที่ตั้งของบริษัทfoundingDatestring วันที่ก่อตั้ง รูปแบบอิสระisCustomerboolean ว่าพวกเขาเป็นลูกค้าอยู่แล้วหรือไม่isLaunchedboolean ว่าผลิตภัณฑ์เปิดใช้งานอยู่หรือไม่
curl -s -X POST "https://www.aidirectori.es/api/v1/submit-ai-tool" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Tool",
"website": "https://mytool.com",
"tagline": "One-line pitch",
"description": "What the product does.",
"category": "productivity",
"pricing": "FREE",
"paymentType": "pro",
"founderName": "Jane Founder",
"founderEmail": "jane@mytool.com",
"tags": ["ai", "productivity"],
"icon": "https://mytool.com/icon.png",
"frame": "https://mytool.com/screenshot.png",
"screenshots": ["https://mytool.com/gallery-1.png"]
}'
ตรวจสอบสถานะการส่ง
GET https://www.aidirectori.es/api/v1/ai-tools/status — ค้นหาเครื่องมือที่คีย์ของคุณส่งด้วยหนึ่งใน id, slug, หรือ website เครื่องมือของไคลเอนต์อื่นคืนค่า 404
ใช้ได้ตลอดเวลา — ไม่เพียงเมื่อเว็บฮุคทำงาน ตรวจสอบในขณะที่ summary.isComplete เป็น false จากนั้นหยุด (หรือรอ Done) submissionState เป็น IN_QUEUE, ASSIGNED, IN_PROGRESS, REVIEW, DONE, หรือ null เมื่อไม่มีเวิร์กโฟลว์ไดเรกทอรี
curl -s "https://www.aidirectori.es/api/v1/ai-tools/status?slug=my-ai-tool" \
-H "X-API-Key: YOUR_API_KEY"
เว็บฮุค
เราส่ง JSON ไปยัง URL HTTPS ที่เก็บไว้ในไคลเอนต์ API ของคุณ — ไม่ส่งในการส่งแต่ละครั้ง ให้ URL แก่เราเมื่อคุณสมัคร; เรเก็บเป็น webhookUrl และส่งความลับการเซ็นชื่อให้คุณ ทั้งเหตุการณ์ directory-Done และการตอบกลับการสนับสนุนไปยังเอนด์พอยต์เดียวกัน
เหตุการณ์ไดเรกทอรีเกิดขึ้นเมื่อแอดมินคลิก Done บนเครื่องมือที่คีย์ของคุณส่ง และ webhookUrl ถูกตั้งค่า URL ที่ขาดหายไป: เราไม่ส่งอะไร เอนด์พอยต์ของคุณล่มหรือไม่คืน 2xx: เครื่องมือยังถูกทำเครื่องหมาย Done เรายังไม่ลองใหม่ — ตรวจสอบสถานะหากคุณต้องการทางเลือกสำรอง
เหตุการณ์
2
อ่าน X-AI-Directories-Event ก่อนแยกวิเคราะห์เนื้อหา
ฟิลด์ชนิดหมายเหตุ
directory_submissions.completedDone แอดมินทำเครื่องหมายงานไดเรกทอรี Done สำหรับเครื่องมือที่คีย์ของคุณส่ง Payload คือ { event, occurredAt, tool, summary, submissions }support.repliedreply การตอบกลับการสนับสนุนพร้อมแล้ว (AI หรือมนุษย์) Payload คือ { event, occurredAt, conversation } เฉพาะเมื่อเปิดการสนับสนุน
คำขอ
| Method | POST |
|---|---|
| Content-Type | application/json |
| Auth | ส่วนหัว HMAC — ไม่ใช่คีย์ API ของคุณ |
ส่วนหัว
3
ฟิลด์ชนิดหมายเหตุ
X-AI-Directories-Eventstring Payload ที่คุณได้รับ แยกสาขาที่ค่านี้ — URL เดียวกันได้รับทั้งสองเหตุการณ์X-AI-Directories-Signaturestring sha256=<hex> HMAC ของเนื้อหาดิบด้วยความลับการเซ็นชื่อของคุณ มีเมื่อเราออกความลับUser-Agentstring AI-Directories-Webhook/1.0
ตรวจสอบลายเซ็น
HMAC-SHA256 บนเนื้อหาคำขอแบบดิบ ด้วยความลับที่เราให้คุณ เปรียบเทียบ hex digest กับ X-AI-Directories-Signature หลังจากตัดคำนำหน้า sha256= ใช้การเปรียบเทียบที่ปลอดภัยต่อเวลา
const crypto = require("crypto");
function verifySignature(rawBody, signatureHeader, secret) {
const expected = crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
const received = String(signatureHeader || "").replace(/^sha256=/, "");
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received));
}
Payload
submissions รวมเฉพาะไดเรกทอรีที่เราส่งจริง แต่ละแถวสามารถรวม listingUrl ที่ใช้งานจริง ภาพหลักฐาน คะแนนโดเมน และผู้ส่ง (ADMIN หรือ OWNER) คืนค่า 2xx เพื่อยืนยัน
{
"event": "directory_submissions.completed",
"occurredAt": "2026-09-01T13:00:00.000Z",
"tool": {
"id": "64a1b2c3d4e5f6789012345",
"name": "My AI Tool",
"slug": "my-ai-tool",
"website": "https://myaitool.com",
"paymentStatus": "prolist",
"paymentLabel": "Pro · 60+",
"targetDirectoriesCount": 60
},
"summary": {
"submittedCount": 62,
"recordedSubmissions": 62,
"notes": "All high-DR directories completed"
},
"submissions": [
{
"name": "There's An AI For That",
"slug": "theres-an-ai-for-that",
"url": "https://theresanaiforthat.com",
"listingUrl": "https://theresanaiforthat.com/ai/my-ai-tool",
"domainRating": 81,
"isSubmitted": true,
"submittedBy": "ADMIN",
"submittedAt": "2026-09-01T12:00:00.000Z"
}
]
}
การสนับสนุนลูกค้า
ส่งต่อคำถามจาก UI ผลิตภัณฑ์ของคุณ; เราตอบจากฐานความรู้ของคุณเมื่อทำได้ หรือมนุษย์ตอบในแดชบอร์ดของเรา ปิดโดยค่าเริ่มต้น — จนกว่าเราจะเปิดใช้งาน POST /support/ask คืนค่า 403 ใช้ X-API-Key เดียวกับการส่ง MCP ไม่สามารถเรียกใช้สิ่งนี้
โหมดเริ่มต้นคือไฮบริด: AI ตอบเมื่อทำได้ มิฉะนั้นการสนทนายังคงเป็น pending สำหรับมนุษย์ เราสามารถตั้งค่าไคลเอนต์เป็นมนุษย์เท่านั้น (ไม่มี AI) หากไม่มีความรู้ผลิตภัณฑ์ คำถามจะรอคน
ส่งคำถาม
POST https://www.aidirectori.es/api/v1/support/ask
เนื้อหา
5 question เป็นข้อมูลที่จำเป็น ใช้ conversationId หรือ externalId ซ้ำเพื่อดำเนินการต่อในเธรดเดียวกัน ไคลเอนต์ที่ใช้งานโดยมนุษย์เท่านั้นอาจส่ง metadata.peerPushMessageId เพื่อการลองใหม่แบบ idempotent
FieldTypeNotes
questionstring คำถามของลูกค้า สูงสุด 4000 ตัวอักษร message ก็ยอมรับเช่นกันconversationIdstring ดำเนินการต่อเธรดที่เราส่งคืนก่อนหน้านี้externalIdstring รหัสตั๋วหรือเธรดของคุณ การใช้ซ้ำจะดำเนินการสนทนาเดียวกันต่อไปcustomerobject{ name, email, id }เพิ่มเติมสำหรับลูกค้าปลายทาง — ไม่ใช่ผู้ก่อตั้งจากการส่งmetadataobject JSON ใด ๆ ที่เก็บไว้ในการสนทนา
curl -s -X POST "https://www.aidirectori.es/api/v1/support/ask" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"question": "How do I cancel my subscription?",
"externalId": "ticket-123",
"customer": { "name": "Ada", "email": "ada@example.com" }
}'
ไฮบริด/AI: 200 กับ status: "answered" หมายความว่า reply พร้อมแล้ว (replySource คือ ai หรือ human) pending หมายถึงให้รอหรือรอ webhook
{
"success": true,
"data": {
"id": "64a1b2c3d4e5f6789012345",
"status": "answered",
"externalId": "ticket-123",
"reply": "You can cancel from Settings → Billing.",
"replySource": "ai",
"messages": [
{ "role": "customer", "content": "How do I cancel my subscription?" },
{ "role": "assistant", "content": "You can cancel from Settings → Billing.", "source": "ai" }
]
}
}
ไคลเอนต์ที่ใช้งานโดยมนุษย์เท่านั้นจะได้รับซองข้อมูลแบบบาง — ไม่มีประวัติ customer หรือ messages[] message คือ null จนกว่ามนุษย์จะตอบกลับ จากนั้นจึงเป็นข้อความจากตัวแทนเพียงหนึ่งข้อความ
{
"success": true,
"data": {
"id": "64a1b2c3d4e5f6789012345",
"externalId": "ticket-123",
"status": "pending",
"message": null
}
}
สอบถามการสนทนา
GET https://www.aidirectori.es/api/v1/support/conversations/:id — หรือแสดงรายการด้วย ?id=, ?externalId= หรือ ?status=pending ช่วงเวลาที่แนะนำขณะรอ: 5–15 วินาที ผลลัพธ์รายการแบบไฮบริดจะละเว้นอาร์เรย์ messages เต็มรูปแบบ; แบบมนุษย์เท่านั้นจะส่งคืนรูปแบบบางเหมือนกับ ask
curl -s "https://www.aidirectori.es/api/v1/support/conversations/64a1b2c3d4e5f6789012345" \
-H "X-API-Key: YOUR_API_KEY"
Webhook เมื่อมีคำตอบพร้อม
หากตั้งค่า webhookUrl เราจะ POST support.replied — ใช้ HMAC เดียวกับ directory Done เพย์โหลดไฮบริด/AI ใช้ reply / replySource แบบมนุษย์เท่านั้นใช้ conversation.message เอกพจน์พร้อม role: "agent" และ source: "human"
{
"event": "support.replied",
"occurredAt": "2026-09-09T09:01:00.000Z",
"conversation": {
"id": "64a1b2c3d4e5f6789012345",
"status": "answered",
"externalId": "ticket-123",
"reply": "You can cancel from Settings → Billing.",
"replySource": "human"
}
}
{
"event": "support.replied",
"occurredAt": "2026-09-11T12:00:00.000Z",
"conversation": {
"id": "64a1b2c3d4e5f6789012345",
"externalId": "ticket-123",
"status": "answered",
"message": {
"id": "...",
"role": "agent",
"source": "human",
"content": "Thanks — here's how to cancel…",
"createdAt": "2026-09-11T12:00:00.000Z"
}
}
}
อีเมล support@thedirectori.es เพื่อขอคีย์, URL ของ webhook, signing secret หรือสิทธิ์การเข้าถึงการสนับสนุน — หรือสมัครจาก Got a directory?
Reference / Rate limits
ขีดจำกัดอัตรา
คีย์มาตรฐานได้รับ 10 คำขอต่อนาที คีย์พรีเมียมได้รับ 60 คำขอ ส่วนหัวในทุกการตอบกลับ
ขีดจำกัดเป็นต่อคีย์ API ไม่ใช่ต่อ IP — และ REST และ MCP ใช้โควต้าแยกกัน ดังนั้นการระเบิดของเอเจนต์จะไม่ทำให้สคริปต์ฝั่งเซิร์ฟเวอร์ของคุณอดอยาก
| คีย์ | REST / นาที | MCP / นาที |
|---|---|---|
มาตรฐาน (aid_ จากแดชบอร์ด) | 10 | 30 |
| พรีเมียม (แผน Catalog API แบบชำระเงิน, การอนุญาตจากผู้ดูแล หรือคีย์พันธมิตรที่ออกให้) | 60 | 120 |
โควต้า MCP ใหญ่กว่าเพราะเอเจนต์กระจายงาน: คำถามหนึ่งจากผู้ใช้มักกลายเป็นการเรียกเครื่องมือแบบขนานหลายครั้ง
การจับมือฟรี
initialize, notifications/initialized, ping และ tools/list ไม่มีค่าใช้จ่าย การเชื่อมต่อไคลเอนต์หรือรีสตาร์ทไม่ใช้โควต้าของคุณ — เฉพาะ tools/call เท่านั้นที่ใช้ คำขอที่มีรูปแบบไม่ถูกต้องก็ไม่ถูกคิดค่าใช้จ่ายเช่นกัน
ทุกการตอบกลับรวมถึง X-RateLimit-Limit, X-RateLimit-Remaining และ X-RateLimit-Reset 429 ยังส่ง Retry-After
อัปเกรดจาก แดชบอร์ดนักพัฒนาของคุณ ($9/เดือน) อย่าปลอมตัวเป็นครอว์เลอร์ของเครื่องมือค้นหาหรือผู้ช่วยเพื่อดัมพ์แคตตาล็อก
ต้องการขีดจำกัดที่สูงขึ้นหรือไม่? อีเมล support@thedirectori.es
คีย์พันธมิตรสำหรับส่ง/สนับสนุนมีขีดจำกัดการเขียนของตนเอง; พวกเขาใช้โควต้าแคตตาล็อกพรีเมียมเมื่ออ่าน
Reference / Errors
ข้อผิดพลาด
รูปร่างข้อผิดพลาด JSON และรหัสสถานะ HTTP
{ "success": false, "error": "Tool not found." }
| HTTP | ความหมาย |
|---|---|
| 400 | คำขอไม่ถูกต้อง |
| 401 | คีย์ API หายไปหรือไม่ถูกต้อง |
| 403 | คีย์ถูกต้องแต่ฟีเจอร์ไม่เปิดใช้งาน |
| 404 | ไม่พบเครื่องมือ ไดเรกทอรี หรือการสนทนา |
| 429 | ขีดจำกัดอัตรา |
| 500 / 503 | ปัญหาเซิร์ฟเวอร์หรือฐานข้อมูล — ลองใหม่ |
MCP ใช้ข้อผิดพลาด JSON-RPC (-32601 ไม่พบเมธอด, -32603 ภายใน และเพย์โหลด isError ของเครื่องมือ)