مستندات جامع REST API و SDKهای هوش مصنوعی

مرکز اتصال و توسعه پلتفرم فلای‌کراول

استخراج پرسرعت صفحات وب به Fit-Markdown، نقشه‌برداری سریع دامنه (map/)، سرچ زنده وب (search/)، اسکرپ دسته‌ای و استخراج ساختاریافته با هوش مصنوعی (extract/) برای پایتون، لنگ‌چین، کلود و نودجی‌اس.

🧪 Swagger OpenAPI Spec 🤖 Model Context Protocol (MCP) 🔑 دریافت کلید API
POST /scrape

Web to Markdown

Single-page fast extraction + actions & caching.

POST /map

Site Mapper

Discover all URLs on a domain in <2 seconds.

POST /search

Search & Scrape

Live web search with auto-scraped Markdown results.

POST /extract

LLM Schema Extract

Extract typed JSON data matching any schema.

POST /batch/scrape

Batch Scraper

Scrape 50+ URLs concurrently in parallel.

🧪 کنسول تست زنده API در مستندات
HTTP 200 OK — JSON Response
// Output will appear here after clicking 'Send Live Request'
🤖 AI AGENTS PROTOCOL
Model Context Protocol (MCP) v3.5

🤖 FlyCrawl Model Context Protocol (MCP) Server

اتصال مستقیم و بومی FlyCrawl به Claude Desktop، محیط توسعه Cursor، Windsurf و ایجنت‌های هوش مصنوعی به عنوان ابزار تبدیل وب به مارک‌داون، جستجوی زنده و نقشه‌برداری سایت.

File: claude_desktop_config.json
{
  "mcpServers": {
    "flycrawl": {
      "command": "python",
      "args": ["-m", "flycrawl.mcp"],
      "env": {
        "FLYCRAWL_API_URL": "http://localhost:5120/api/v1",
        "FLYCRAWL_API_KEY": "fly_live_your_api_key"
      }
    }
  }
}

🛠️ ابزارهای ارائه‌شده به هوش مصنوعی در پروتکل MCP

⚡ flycrawl_scrape
استخراج و تبدیل تک‌صفحه به مارک‌داون تمیز.
🗺️ flycrawl_map
نقشه‌برداری و کشف تمام لینک‌های دامنه زیر ۲ ثانیه.
🔍 flycrawl_search
جستجوی زنده وب و اسکرپ نتایج به مارک‌داون.
🧠 flycrawl_extract
استخراج هوشمند دیتای ساختاریافته با JSON Schema.
🕸️ flycrawl_crawl
کراول بازگشتی و عمیق چندصفحه‌ای سایت.

نمونه کدهای آماده و SDKهای رسمی

# pip install flycrawl
from flycrawl import FlyCrawlApp

app = FlyCrawlApp(api_key="fly_live_your_api_key")

# 1. Scrape with Fit-Markdown & 24h Smart Cache
doc = app.scrape_url("https://example.com", params={"format": "markdown", "maxAge": 86400})
print(doc["content"])

# 2. Fast Site Mapping (<2s)
sitemap = app.map_url("https://example.com", params={"limit": 1000})
print(f"Discovered {sitemap['total_links']} URLs")

# 3. Live Web Search & Auto-Scrape
search_results = app.search("latest LLM reasoning benchmarks", limit=5)
for res in search_results["results"]:
    print(res["title"], res["url"])
            
🤖 سرور بومی پروتکل کانتکست مدل (MCP)

مستندات اتصال سرور MCP به ابزارهای هوش مصنوعی

JSON-RPC 2.0 Endpoint: /api/v1/mcp

فلای‌کراول را به عنوان یک سرور ابزار بومی به Cursor IDE، کلود دسکتاپ، Windsurf یا ایجنت‌های هوش مصنوعی متصل کنید تا مدل‌ها بتوانند خودکار وب را اسکرپ، جستجو و برداری کنند.

{
  "mcpServers": {
    "flycrawl": {
      "url": "https://api.flycrawl.net/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FLYCRAWL_API_KEY"
      }
    }
  }
}
                    
flycrawl_vectorize

Web Scrape + Chunk + 1536-dim Embedding

flycrawl_scrape

Ultra-clean Fit-Markdown for LLM prompts

flycrawl_search

Live real-time search with scraped results

flycrawl_crawl

Recursive multi-page deep site crawl