API و سرور MCP در AISeeWhy
یک درخواست POST با یک URL به endpoint ممیزی بفرستید و یک گزارش JSON بگیرید: امتیاز 0 تا 100، یافتهها با اولویت، شواهد و راهحلهای آماده، به هر یک از 60 زبان. عاملهای هوش مصنوعی به endpoint MCP وصل میشوند و audit_url را فراخوانی میکنند. بدون کلید اشتراک پولی، پیشنمایش دریافت میکنید.
POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp
چطور API را فراخوانی کنم؟
curl -s https://api.aiseewhy.com/v1/audit \
-H 'content-type: application/json' \
-H 'x-api-key: asw_…' \
-d '{"url": "https://example.com/pricing", "language": "fa"}' فیلدها: url (الزامی؛ اگر https:// نباشد اضافه میشود)، language (کد زبان گزارش، پیشفرض en)، bots (فهرست اختیاری نام خزندهها)، markdown (افزودن گزارش Markdown). کلید خود را در هدر x-api-key بفرستید. دستههای نقشه سایت از POST /v1/sitemap استفاده میکنند و به کلید نیاز دارند. توصیف OpenAPI.
چطور یک عامل هوش مصنوعی را از طریق MCP وصل کنم؟
یک سرور MCP راه دور با URL زیر (streamable HTTP) اضافه کنید و کلید خود را در هدر x-api-key بفرستید. ابزارها: audit_url، audit_sitemap (تا 10 صفحه) و explain_finding. مستندات Model Context Protocol.
{
"mcpServers": {
"aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
"headers": { "x-api-key": "asw_…" } }
}
} ابزارهای MCP: audit_url، audit_sitemap، compare_urls، crawl_site، watch_site، list_watched_sites، explain_finding.
چطور از آن در Claude Code، Codex یا Cursor استفاده کنم؟
سرور MCP را با یکی از قطعهکدهای زیر در عامل خود وصل کنید. بدون کلید پیشنمایش رایگان میگیرید و با کلید، گزارش کامل. سپس مثلاً بپرسید: «آیا ChatGPT و Perplexity میتوانند example.com/pricing را بخوانند؟ پیدا کن چه چیزی مسدودشان میکند و درستش کن.»
Claude Code
# plugin: MCP server and skills (github.com/aiseewhy/aiseewhy-plugin) /plugin marketplace add aiseewhy/aiseewhy-plugin /plugin install aiseewhy@aiseewhy
claude mcp add --transport http aiseewhy https://api.aiseewhy.com/mcp --header "x-api-key: asw_…"
Codex
# ~/.codex/config.toml
[mcp_servers.aiseewhy]
url = "https://api.aiseewhy.com/mcp"
http_headers = { "x-api-key" = "asw_…" }Cursor
// .cursor/mcp.json
{ "mcpServers": { "aiseewhy": { "url": "https://api.aiseewhy.com/mcp",
"headers": { "x-api-key": "${env:AISEEWHY_API_KEY}" } } } }endpointهای حساب کاربری
با یک نشست واردشده یا کلید API حساب: بررسی مجدد و مقایسه گزارشها، پایش، ممیزی گروهی، لینکهای فقطخواندنی و بررسی لاگ سرور. همه در توصیف OpenAPI فهرست شدهاند.
POST https://api.aiseewhy.com/v1/me/reports/{id}/recheck GET https://api.aiseewhy.com/v1/me/reports/{id}/diff/{other}
POST https://api.aiseewhy.com/v1/compare POST https://api.aiseewhy.com/v1/me/sites
POST https://api.aiseewhy.com/v1/me/bulk GET https://api.aiseewhy.com/v1/me/bulk/{id}/csv
POST https://api.aiseewhy.com/v1/me/crawl GET https://api.aiseewhy.com/v1/me/crawl/{id}/csv
POST https://api.aiseewhy.com/v1/me/reports/{id}/share POST https://api.aiseewhy.com/v1/me/logs
POST https://api.aiseewhy.com/v1/me/keys POST https://api.aiseewhy.com/v1/me/visibility
GET https://api.aiseewhy.com/v1/me/visibility/{id}/csv POST https://api.aiseewhy.com/v1/me/seo/keywords
POST https://api.aiseewhy.com/v1/me/seo/rank POST https://api.aiseewhy.com/v1/me/seo/domain
POST https://api.aiseewhy.com/v1/me/seo/backlinks POST https://api.aiseewhy.com/v1/me/gsc/query
POST https://api.aiseewhy.com/v1/me/links GET https://api.aiseewhy.com/v1/me/links/{id}/csv
POST https://api.aiseewhy.com/v1/me/seo/offsite POST https://api.aiseewhy.com/v1/me/seo/business چطور صفحهها را در CI بررسی کنم؟
GitHub Action در هر pull request یک استقرار پیشنمایش را بررسی میکند و اگر یک خزنده هوش مصنوعی مسدود شود یا امتیاز افت کند، build را ناموفق میکند. بدون کلید از پیشنمایش رایگان استفاده میکند. GitHub Marketplace.
- uses: aiseewhy/check-action@v1
with:
url: ${{ steps.deploy.outputs.preview-url }}
api-key: ${{ secrets.AISEEWHY_API_KEY }} # optional
fail-on: P1 # P1, P2, P3 or none
min-score: 70 چطور امتیاز را در سایتم نشان دهم؟
صفحه را در حساب خود به پایش اضافه کنید و نشان آن را کپی کنید: یک تصویر کوچک با امتیاز زنده که به AISeeWhy لینک میدهد. پایش.
<a href="https://aiseewhy.com/"><img src="https://api.aiseewhy.com/v1/badge/….svg" alt="AI-readable score by AISeeWhy" width="128" height="20"></a>
یک یافته چه شکلی است؟
{
"id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
"evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
"fixes": [ { "kind": "cloudflare", "body": "…" } ]
} اولویتها: P1 یعنی پاسخهای هوش مصنوعی نمیتوانند صفحه را بخوانند یا به آن استناد کنند، P2 مهم است، P3 خوب است داشته باشید یا یک انتخاب سیاستی است، مثلاً مسدود کردن یک خزنده آموزشی. robots.txt طبق تعریف RFC 9309 خوانده میشود. RFC 9309.
محدودیتها چیست؟
| دسترسی | محدودیت |
|---|---|
| بدون کلید یا حساب | پیشنمایش (اولین یافته)، روزی 1 بررسی برای هر شبکه |
| اشتراک پولی (وبسایت) | گزارش کامل و تاریخچه: روزی 30 بررسی در Pro، 100 در Business، 200 در Agency، 300 در Enterprise |
| کلید API اشتراک پولی (API و MCP) | گزارش کامل: روزی 100 ممیزی در Pro، 300 در Business، 650 در Agency، 1,000 در Enterprise؛ دستههای نقشه سایت تا 50 URL |
| ممیزی دستهای بر اساس نقشه سایت | تا 5,000 URL در هر اجرا، پرداخت بهازای هر URL ممیزیشده |
درخواست به نشانیهای خصوصی یا داخلی رد میشود. صفحههایی که ممیزیشان ممکن نیست با یافته fetch.error یا fetch.status گزارش میشوند.
پرسش درباره اشتراکها، پرداخت یا دادههای شما: support@aiseewhy.com