التوثيق

توثيق ParseJet

يستخرج ParseJet النص من أي ملف أو عنوان URL. مكالمة API واحدة تتعامل مع PDF وDOCX وYouTube وصفحات الويب والصور والصوت والفيديو وأكثر من 25 تنسيقًا آخر.

بدء سريع

احصل على نتيجة التحليل الأولى في أقل من 60 ثانية. لا يلزم تسجيل.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Add your API key to requests
curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "webpage",
  "metadata": { "url": "https://example.com" }
}

المصادقة

يقدم ParseJet ثلاثة مستويات من الوصول. يمكنك البدء في استخدام API على الفور دون أي مصادقة.

المفاهيم الأساسية

الصيغ المدعومة

ParseJet تكتشف تلقائيًا الصيغة من امتداد الملف أو نمط URL. لا تحتاج إلى تحديد الصيغة — فقط أرسل الملف أو URL إلى /v1/parse/auto وParseJet يتولى الباقي.

الاعتمادات

كل طلب API يستهلك اعتمادات بناءً على تعقيد الصيغة التي يتم تحليلها. ملفات النص البسيطة تكلف 1 اعتماد، بينما نصوص YouTube تكلف 5. بدلتك الشهرية من الاعتمادات تعتمد على خطتك.

صيغة الإخراج

بشكل افتراضي، ParseJet تُرجع النص المستخرج الخام. أضف ?output_format=markdown إلى أي طلب للحصول على إخراج معالج يحتوي على العناوين والقوائم والجداول وكتل التعليمات البرمجية المكتشفة.

دليل

تحليل ملف PDF

استخراج النص من أي ملف PDF، بما في ذلك المستندات الممسوحة ضوئيًا والتقارير متعددة الصفحات.

رفع ملف PDF

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

تحويل إلى Markdown

أضف output_format=markdown للحفاظ على هيكل المستند:

curl -X POST https://api.parsejet.com/v1/parse/auto/file?output_format=markdown \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

دليل

نصوص YouTube

احصل على النص الكامل لأي فيديو على YouTube. يدعم الترجمة التلقائية بأكثر من 100 لغة.

الحصول على نص

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID"}'

تحديد اللغة

استخدم معامل language لمقاطع الفيديو غير الإنجليزية:

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "ja"}'

أو استخدم الكشف التلقائي

نقطة النهاية /v1/parse/auto/url تكتشف تلقائيًا روابط YouTube:

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/VIDEO_ID"}'

دليل

استخراج محتوى الويب

استخرج المحتوى الرئيسي من أي صفحة ويب. يقوم ParseJet تلقائيًا بإزالة التنقل والإعلانات والشرائط الجانبية والمحتوى القياسي.

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/blog/article"}'

دليل

مستندات المكتب

حلل ملفات Word (DOCX) وExcel (XLSX) وPowerPoint (PPTX) وCSV. فقط قم برفع الملف — يكتشف ParseJet التنسيق تلقائيًا.

# Works with any Office format
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

# Also works with spreadsheets
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

مرجع API

تنسيق الاستجابة

جميع نقاط النهاية تُرجع نفس بنية JSON:

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "pdf",
  "metadata": { "pages": 12, "author": "Jane Doe" }
}

نقطة النهاية الموصى بها. تكتشف التنسيق تلقائيًا من امتداد الملف أو نوع URL. تقبل file (متعدد الأجزاء) أو url (حقل نموذج)، وليس كلاهما.

curl -X POST https://api.parsejet.com/v1/parse/auto \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

حلل أي URL. يميز تلقائيًا بين YouTube وصفحات الويب العادية.

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

حلل أي ملف مرفوع. يكتشف التنسيق من امتداد الملف، مع تراجع إلى الكشف القائم على المحتوى.

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

استخرج المحتوى الرئيسي من صفحة ويب. يزيل التنقل والإعلانات والمحتوى القياسي.

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

استخرج النص من فيديو YouTube. تتضمن البيانات الوصفية video_id، القناة، والمدة.

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "en"}'

حلل ملفات الصوت. يدعم MP3، WAV، M4A، OGG، FLAC، WebM. الحد الأقصى 25 ميجابايت.

curl -X POST https://api.parsejet.com/v1/parse/audio \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

استخرج الصوت من الفيديو للتحويل إلى نص. يدعم MP4، MKV، AVI، MOV، WebM.

curl -X POST https://api.parsejet.com/v1/parse/video \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

حلل كتاب EPUB. يستخرج النص منظمًا حسب الفصول.

curl -X POST https://api.parsejet.com/v1/parse/epub \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

حلل موجز RSS أو Atom. يدعم أيضًا OPML عبر /v1/parse/opml.

curl -X POST https://api.parsejet.com/v1/parse/feed \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

حلل الصورة. يدعم JPG، PNG، GIF، BMP، WebP، TIFF. الحد الأقصى 20 ميجابايت.

curl -X POST https://api.parsejet.com/v1/parse/image \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "prompt=Describe this image"

استخرج النص من الصورة عبر OCR.

curl -X POST https://api.parsejet.com/v1/parse/image/ocr \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

SDKs

SDKs الرسمية

npm install parsejet

import { ParseJet } from "parsejet";

const client = new ParseJet({ apiKey: "pj_YOUR_KEY" });

// Parse a URL
const result = await client.parse.url("https://example.com");
console.log(result.text);

// Parse a file
const result = await client.parse.file(buffer, "report.pdf");
console.log(result.text);

pip install parsejet

from parsejet import ParseJet

client = ParseJet(api_key="pj_YOUR_KEY")

# Parse a URL
result = client.parse.url("https://example.com")
print(result.text)

# Parse a file
with open("report.pdf", "rb") as f:
    result = client.parse.file(f, "report.pdf")
    print(result.text)

وكلاء الذكاء الاصطناعي

خادم MCP

استخدم ParseJet كخادم MCP (بروتوكول سياق النموذج) مع Claude Code أو Cursor أو أي وكيل ذكاء اصطناعي متوافق مع MCP.

التثبيت

npm install -g @parsejet/mcp-server

Claude Code

أضف إلى ملف مشروعك .claude/settings.json:

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Cursor

انتقل إلى الإعدادات → خوادم MCP، أضف خادمًا جديدًا:

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Claude.ai (عن بُعد)

لـ Claude.ai على الويب، استخدم نقطة النهاية HTTP البعيدة — لا حاجة لتثبيت محلي:

Endpoint:  https://api.parsejet.com/mcp
Transport: Streamable HTTP
Auth:      Bearer pj_YOUR_KEY (in Authorization header)

انتقل إلى Claude.ai → الإعدادات → التكاملات → إضافة خادم MCP → أدخل عنوان URL أعلاه.

الأدوات المتاحة

حدود المعدل والتسعير

يستخدم ParseJet نظامًا قائمًا على الرصيد. يستهلك كل طلب رصيدًا بناءً على تعقيد التنسيق.

تتضمن رؤوس الاستجابة X-RateLimit-Limit، X-RateLimit-Remaining، X-RateLimit-Reset، و Retry-After على استجابات 429.

رموز الأخطاء

جميع الأخطاء تُرجع JSON مع حقول error و message.