كيفية استخدام أداة Claude Web Fetch API

إن منح ذكائك الاصطناعي القدرة على الاستفادة من بيانات الويب في الوقت الفعلي يشبه منحه قوة خارقة. وهذا بالضبط ما تفعله أداة Claude Web Fetch API لـ Claude، الذكاء الاصطناعي للمحادثة من Anthropic. تم إطلاق هذه الواجهة البرمجية (API) في مرحلة تجريبية عام 2025، وهي تمكّن Claude من استرداد المحتوى الكامل من صفحات الويب وملفات PDF، متحررة من قيود بيانات التدريب الثابتة. سواء كنت تقوم بإنشاء تطبيق يحتاج إلى أحدث اتجاهات السوق أو تحليل تقرير PDF، فإن أداة Web Fetch تجعل من Claude شريكًا ديناميكيًا في جلب ومعالجة البيانات الحية. في هذا التعمق التقني، سنستكشف ما هي أداة Claude Web Fetch API، وكيف تختلف عن خوادم MCP، والنماذج التي تدعمها، وكيفية اختبارها باستخدام الكود وأدوات مثل Apidog، وتفاصيل استخدامها وتسعيرها. دعنا نتعمق تقنيًا ونطلق العنان للإمكانات الكاملة لهذه الواجهة البرمجية (API) التي تغير قواعد اللعبة!

💡

هل تريد أداة رائعة لاختبار واجهات برمجة التطبيقات (API) تولد توثيقًا جميلًا لواجهة برمجة التطبيقات؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى إنتاجية؟

Apidog يلبي جميع متطلباتك، ويحل محل Postman بسعر أكثر بأسعار معقولة بكثير!

button

ما هي أداة Claude Web Fetch API؟

تُعد أداة Claude Web Fetch API ميزة تجريبية تسمح لـ Claude بجلب ومعالجة المحتوى النصي الكامل من صفحات الويب وملفات PDF المحددة عبر نقطة نهاية API مخصصة. على عكس نماذج اللغات الكبيرة التقليدية (LLMs) المقيدة بحدود بيانات التدريب الخاصة بها، تتيح هذه الأداة لـ Claude الوصول إلى محتوى الويب المباشر، مما يجعلها مثالية للمهام التي تتطلب معلومات حديثة - مثل تحليل المقالات الحديثة أو استخراج البيانات من ملفات PDF عبر الإنترنت. يتم الوصول إليها من خلال Anthropic API على /v1/messages مع نوع الأداة web_fetch_20250910، وتتطلب رأسًا تجريبيًا (web-fetch-2025-09-10) للتفعيل.

كيف تختلف عن خادم MCP (بروتوكول سياق النموذج)؟ بينما يوفر خادم MCP طريقة موحدة لـ Claude للاتصال بأدوات خارجية أو مصادر بيانات (مثل قواعد البيانات المخصصة أو واجهات برمجة التطبيقات)، فإن أداة Web Fetch هي ميزة أصلية لـ Anthropic خصيصًا لاسترداد محتوى الويب و PDF. تعد خوادم MCP أكثر مرونة، مما يسمح بالتكاملات المخصصة، ولكنها تتطلب إعدادًا واستضافة. على النقيض من ذلك، تعد أداة Web Fetch حلاً جاهزًا لمحتوى الويب، مع قيود أمان مدمجة مثل بناء URL المقيد لمنع تسرب البيانات. فكر في MCP كجسر مخصص وأداة Web Fetch كطريق سريع جاهز لبيانات الويب.

النماذج المدعومة من Claude Web Fetch

تدعم مجموعة من نماذج Claude أداة Claude Web Fetch API، مما يضمن المرونة لحالات الاستخدام المختلفة. اعتبارًا من سبتمبر 2025، النماذج المتوافقة هي:

Claude Opus 4.1 (claude-opus-4-1-20250805)
Claude Opus 4 (claude-opus-4-20250514)
Claude Sonnet 4 (claude-sonnet-4-20250514)
Claude Sonnet 3.7 (claude-3-7-sonnet-20250219)
Claude Haiku 3.5 (claude-3-5-haiku-latest)

يمكن لهذه النماذج الاستفادة من أداة Web Fetch لجلب المحتوى عند تضمينها في طلب API مع الرأس التجريبي المناسب. يضمن هذا التوافق الواسع أن المطورين يمكنهم اختيار النموذج الذي يناسب احتياجاتهم، من Opus عالي الأداء إلى Haiku الفعال من حيث التكلفة.

كيفية اختبار أداة Claude Web Fetch API باستخدام الكود

يعد اختبار أداة Claude Web Fetch API أمرًا بسيطًا باستخدام Anthropic API. ستحتاج إلى مفتاح API (يتم إنشاؤه في وحدة تحكم Anthropic) والرأس التجريبي web-fetch-2025-09-10. إليك نموذج أمر curl لجلب المحتوى من عنوان URL:

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: web-fetch-2025-09-10" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-opus-4-1-20250805",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Please analyze the content at https://example.com/article"
      }
    ],
    "tools": [
      {
        "type": "web_fetch_20250910",
        "name": "web_fetch",
        "max_uses": 5,
        "allowed_domains": ["example.com"],
        "citations": { "enabled": true },
        "max_content_tokens": 100000
      }
    ]
  }'

إذا كنت تفضل بايثون:

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-1-20250805",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Please analyze the content at https://example.com/article"
        }
    ],
    tools=[{
        "type": "web_fetch_20250910",
        "name": "web_fetch",
        "max_uses": 5
    }],
    extra_headers={
        "anthropic-beta": "web-fetch-2025-09-10"
    }
)
print(response)

يخبر هذا الطلب Claude بجلب وتحليل المحتوى من https://example.com/article. تتضمن المعلمات الرئيسية ما يلي:

max_uses: يحدد عدد مرات الجلب (مثل 5) للتحكم في استخدام الموارد.
allowed_domains: يقيد عمليات الجلب بالنطاقات الموثوقة (مثل example.com).
citations: يُمكّن مراجع المصدر في الردود.
max_content_tokens: يحدد الحد الأقصى لطول المحتوى لإدارة استهلاك الرموز.

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

الاختبار باستخدام Apidog

للتأكد من أن تكامل أداة Claude Web Fetch API الخاص بك لا تشوبه شائبة، فإن الاختبار باستخدام أداة مثل Apidog يعد خطوة ذكية. Apidog، وهي منصة قوية لاختبار واجهات برمجة التطبيقات، تبسط التحقق من صحة نقاط النهاية والاستجابات. وفقًا لـ دليل Apidog حول Claude's Web Search API، يمكنك اختبار أداة Web Fetch على النحو التالي:

إعداد Apidog: قم بتنزيل Apidog من apidog.com/download أو استخدم الإصدار الويب. أنشئ مشروعًا جديدًا.

2. إضافة نقطة النهاية: أدخل نقطة نهاية Anthropic API (https://api.anthropic.com/v1/messages) وقم بتكوين الرؤوس (x-api-key، anthropic-version، anthropic-beta).

3. طلبات الاختبار: أنشئ طلبًا يعكس مثال curl أعلاه. حدد عنوان URL للاختبار (مثل https://example.com/article) وتحقق من مخطط الاستجابة، مع التأكد من صحة الحقول مثل content و citations.

4. تصحيح الأخطاء: استخدم واجهة Apidog للتحقق من المشكلات مثل مفاتيح API غير الصالحة أو النطاقات المحظورة أو حدود المعدل. اختبر الحالات الهامشية، مثل جلب ملف PDF أو الوصول إلى حد max_uses.

تسهل أدوات Apidog المرئية التكرار، مما يضمن أن تكامل أداة Web Fetch جاهز للإنتاج. إنه مفيد بشكل خاص للتحقق من أن Claude يعالج المحتوى الذي تم جلبه بشكل صحيح دون أخطاء.

button

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

يعد استخدام أداة Claude Web Fetch API سلسًا، ولكنه يأتي مع اعتبارات محددة:

الاستخدام: يتم استدعاء الأداة عن طريق تضمينها في مصفوفة tools لطلب API. يقرر Claude متى يجلب المحتوى بناءً على المطالبة وعناوين URL المتاحة، ويسترد النص الكامل أو يستخرج محتوى PDF. يمكنك تقييد عمليات الجلب باستخدام max_uses أو تقييد النطاقات باستخدام allowed_domains لتعزيز الأمان. تدعم واجهة برمجة التطبيقات ما يصل إلى 100,000 رمز محتوى لكل عملية جلب، وهو ما يكفي لمعظم صفحات الويب أو المستندات.
التسعير: اعتبارًا من سبتمبر 2025، أداة Web Fetch في مرحلة تجريبية ومضمنة في استخدام API القياسي للنماذج المدعومة. ومع ذلك، فإنها تتكبد تكاليف رمز إضافية للمحتوى الذي تم جلبه، والذي يحتسب ضمن حدود الرموز لنموذجك. يعتمد التسعير على النموذج المستخدم (على سبيل المثال، Opus 4.1 أغلى من Haiku 3.5). تحقق من تسعير Anthropic على docs.anthropic.com للحصول على التفاصيل، حيث قد تكون للميزات التجريبية أسعار ترويجية. بالنسبة للمؤسسات، تقدم خطط Enterprise خصومات على الحجم وعناصر تحكم إدارية لإدارة تكاليف API.

كن حذرًا من استهلاك الرموز، خاصة مع صفحات الويب أو ملفات PDF الكبيرة، واستخدم max_content_tokens لتحديد التكاليف. تعني حالة الإصدار التجريبي أنه يجب عليك تقديم ملاحظات عبر نموذج Anthropic للمساعدة في تحسين الأداة.

اعتبارات الأمان عند استخدام أداة Claude's Web Fetch API

تم تصميم أداة Claude Web Fetch API مع مراعاة الأمان، ولكنها لا تخلو من المخاطر. لمنع تسرب البيانات، لا يمكن لـ Claude إنشاء عناوين URL ديناميكيًا - فهي تجلب فقط عناوين URL التي يوفرها المستخدم أو تلك من نتائج البحث/الجلب السابقة على الويب. يمكنك تأمينها بشكل أكبر عن طريق:

تعيين allowed_domains لمواقع موثوقة (مثل ["docs.example.com"]).
استخدام blocked_domains لاستبعاد المواقع الخطرة.
تقييد max_uses للتحكم في تكرار الجلب.

ومع ذلك، تظل هجمات حقن الأوامر مصدر قلق، حيث يمكن أن يؤثر المحتوى الضار في الصفحات التي تم جلبها على سلوك Claude. توصي Anthropic باستخدام الأداة في بيئات موثوقة ومراقبة الاستجابات بحثًا عن أي شذوذ. إذا كانت أمان البيانات أمرًا بالغ الأهمية، ففكر في تعطيل أداة Web Fetch بالكامل أو تقييدها على النطاقات المعتمدة.

Security Considerations When using Claude's Web Fetch API Tool

الخلاصة

تُعد أداة Claude Web Fetch API قفزة قوية إلى الأمام لـ Claude، حيث تمكنه من الاستفادة من محتوى الويب و PDF المباشر بسهولة. من خلال دمج هذه الواجهة البرمجية (API) في سير عملك، يمكنك تعزيز قدرة Claude على تقديم استجابات في الوقت المناسب وغنية بالسياق. من الاختبار باستخدام Apidog إلى تكوين عمليات جلب آمنة، تعد هذه الأداة حلم المطور لبناء تطبيقات ذكية. بينما تتطلب حالتها التجريبية وتكاليف الرموز إدارة دقيقة، تفتح أداة Web Fetch إمكانيات لا حصر لها لتحليل البيانات في الوقت الفعلي. لذا، احصل على مفتاح API الخاص بك، وابدأ اختبارًا في Apidog، ودع Claude يستكشف الويب كما لم يحدث من قبل!

button