المكتبات (SDKs)
مكتبات ARASE الرسمية لـ Python و JavaScript/TypeScript
المكتبات (SDKs)
مكتبات رسمية لاستخدام ARASE API.
التثبيت
bash pip install arase-sdk bash npm install arase البداية السريعة
ابحث في الويب بـ 3 أسطر فقط:
from arase import AraseClient
# يقرأ تلقائياً ARASE_API_KEY من متغيرات البيئة
client = AraseClient()
response = client.search("أفضل المطاعم في الرياض")
print(response.answer)import { AraseClient } from "arase";
// يقرأ تلقائياً ARASE_API_KEY من متغيرات البيئة
const client = new AraseClient();
const response = await client.search("أفضل المطاعم في الرياض");
console.log(response.answer);استخراج المحتوى
from arase import AraseClient
client = AraseClient()
response = client.extract("https://example.com/article")
print(response.content)
print(response.summary)import { AraseClient } from "arase";
const client = new AraseClient();
const response = await client.extract("https://example.com/article");
console.log(response.content);
console.log(response.summary);متغيرات البيئة
المكتبة تقرأ تلقائياً من متغير البيئة ARASE_API_KEY:
ARASE_API_KEY=arase_YOUR_API_KEYfrom arase import AraseClient
# يقرأ تلقائياً ARASE_API_KEY من البيئة
client = AraseClient()
# أو مرره مباشرة
client = AraseClient(api_key="arase_YOUR_API_KEY")ARASE_API_KEY=arase_YOUR_API_KEYimport { AraseClient } from "arase";
// يقرأ تلقائياً ARASE_API_KEY من البيئة
const client = new AraseClient();
// أو مرره مباشرة
const client = new AraseClient({ apiKey: "arase_YOUR_API_KEY" });خيارات البحث
from arase import AraseClient
client = AraseClient()
response = client.search("رؤية السعودية 2030",
include_answer=True, # إجابة بالذكاء الاصطناعي
include_images=True, # نتائج الصور
include_news=True, # نتائج الأخبار
include_places=True, # نتائج الأماكن
include_shopping=True, # نتائج التسوق
include_videos=True, # نتائج الفيديو
include_scholar=True, # نتائج أكاديمية
max_results=10, # عدد النتائج
country="sa", # كود الدولة
language="ar", # كود اللغة
)
# الوصول للنتائج
print(response.results) # نتائج الويب
print(response.answer) # إجابة AI
print(response.images) # الصور
print(response.news) # الأخبار
print(response.places) # الأماكنimport { AraseClient } from "arase";
const client = new AraseClient();
const response = await client.search("رؤية السعودية 2030", {
includeAnswer: true, // إجابة بالذكاء الاصطناعي
includeImages: true, // نتائج الصور
includeNews: true, // نتائج الأخبار
includePlaces: true, // نتائج الأماكن
includeShopping: true, // نتائج التسوق
includeVideos: true, // نتائج الفيديو
includeScholar: true, // نتائج أكاديمية
maxResults: 10, // عدد النتائج
country: "sa", // كود الدولة
language: "ar", // كود اللغة
});
// الوصول للنتائج
console.log(response.results); // نتائج الويب
console.log(response.answer); // إجابة AI
console.log(response.images); // الصور
console.log(response.news); // الأخبار
console.log(response.places); // الأماكنخيارات الاستخراج
from arase import AraseClient
client = AraseClient()
response = client.extract("https://example.com/article",
include_summary=True, # ملخص AI
)
print(response.content) # المحتوى الكامل
print(response.summary) # الملخصimport { AraseClient } from "arase";
const client = new AraseClient();
const response = await client.extract("https://example.com/article", {
includeSummary: true, // ملخص AI
});
console.log(response.content); // المحتوى الكامل
console.log(response.summary); // الملخصالعميل غير المتزامن
import asyncio
from arase import AsyncAraseClient
async def main():
async with AsyncAraseClient() as client:
response = await client.search("رؤية السعودية 2030")
print(response.answer)
asyncio.run(main())// JavaScript غير متزامن بشكل افتراضي
import { AraseClient } from "arase";
const client = new AraseClient();
const response = await client.search("رؤية السعودية 2030");
console.log(response.answer);معالجة الأخطاء
from arase import AraseClient, AraseAPIError
client = AraseClient()
try:
response = client.search("query")
except AraseAPIError as e:
print(e.code) # INSUFFICIENT_BALANCE
print(e.message) # رسالة الخطأ
print(e.status) # كود حالة HTTPimport { AraseClient, AraseAPIError } from "arase";
const client = new AraseClient();
try {
const response = await client.search("query");
} catch (error) {
if (error instanceof AraseAPIError) {
console.log(error.code); // INSUFFICIENT_BALANCE
console.log(error.message); // رسالة الخطأ
console.log(error.status); // كود حالة HTTP
}
}دعم TypeScript
دعم كامل لـ TypeScript مع التعريفات:
import { AraseClient, SearchResponse, SearchOptions } from "arase";
const client = new AraseClient();
const options: SearchOptions = {
includeAnswer: true,
maxResults: 10,
};
const response: SearchResponse = await client.search("query", options);