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}" } } } }

mcptry

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