أريز Docs

المكتبات (SDKs)

مكتبات ARASE الرسمية لـ Python و JavaScript/TypeScript

المكتبات (SDKs)

مكتبات رسمية لاستخدام ARASE API.

Python: GitHub | PyPI

JavaScript: GitHub | NPM


التثبيت

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:

.env
ARASE_API_KEY=arase_YOUR_API_KEY
from arase import AraseClient

# يقرأ تلقائياً ARASE_API_KEY من البيئة
client = AraseClient()

# أو مرره مباشرة
client = AraseClient(api_key="arase_YOUR_API_KEY")
.env
ARASE_API_KEY=arase_YOUR_API_KEY
import { 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) # كود حالة HTTP
import { 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);

هل كان هذا مفيداً؟

في هذه الصفحة