انتقل إلى المحتوى
كيفية استخدام Capium Browser

ثبّته، وصادِق عليه، وتحكّم فيه.

Capium Browser هو متصفح Chrome الخفي المملوك لنا، مرخّص لكل جلسة ويُثبَّت بأمر واحد. أضف مفتاح الترخيص وتحكّم فيه محليًا بواجهة Playwright التي تعرفها بالفعل.

تحكّم فيه كما في Playwright

تنقّل وانقر واكتب وانتظر المحددات والشبكة. تعمل واجهة Playwright القياسية دون تغيير.

Chrome خفي حقيقي

نواة Chrome أصلية ومحدّثة دائمًا ومحصّنة ضد اكتشاف الروبوتات، وليست بديلًا وهميًا بوضع headless أو غلافًا معدّلًا.

لقطات الشاشة وملفات PDF

التقط لقطات شاشة للصفحة كاملة أو حوّل أي صفحة إلى PDF، تمامًا كما تفعل مع متصفح محلي.

جلسات متزامنة

شغّل عدة متصفحات في وقت واحد. يُحتسب كل متصفح نشط كجلسة واحدة من حد خطتك.

1. البدء

ثبّت مجموعة الأدوات الخاصة بلغتك. لا شيء تستضيفه بنفسك ولا شيء تعدّله. يُجلب الملف التنفيذي الخفي عند التشغيل الأول ويبقى محدّثًا تلقائيًا.

install.sh
# Python
pip install capiumbrowser
python -m playwright install-deps   # Chromium's OS libraries (once)

# JavaScript / TypeScript
npm install capiumbrowser

أضف مفتاح الترخيص وتحكّم في صفحتك الأولى. فعّل humanize=True لإدخال وتوقيت يشبهان الإنسان.

first_run.py
from capiumbrowser import launch_context

# Your license key is on the dashboard: Dashboard -> Capium Browser.
# Export it once:  export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# launch_context returns (browser, context, page); the always-latest
# stealth binary is downloaded on first run.
browser, ctx, page = launch_context(
    seed=200123,        # one seed = one coherent device
    humanize=True,      # human-like input + timing
    url="https://example.com",
)
print(page.title())
browser.close()

2. المصادقة

يوجد مفتاح الترخيص في لوحة التحكم ضمن Capium Browser. يمكنك إظهاره أو نسخه أو إعادة إصداره هناك. احتفظ به سرًا وحمّله من متغيرات البيئة بدلًا من كتابته في الشيفرة.

auth.py
# Keep the key out of source. Export it in your shell or CI:
#   export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# The SDK reads it from the environment (or ~/.capium/license)
# automatically — nothing to pass in code.
from capiumbrowser import launch_context

browser, ctx, page = launch_context(seed=200123)
  • أعد إصدار المفتاح من لوحة التحكم إذا تعرّض للكشف. يتوقف المفتاح القديم عن العمل فورًا.
  • ترخيص نشط واحد لكل حساب. الفئات الأعلى ترفع عدد الجلسات التي تعمل في وقت واحد.
  • يصرّح المفتاح للملف التنفيذي بالعمل؛ لا حاجة إلى تسجيل دخول أو ملف تعريف ارتباط منفصل.

3. التحكم باستخدام Playwright (Python)

كل ما تعرفه من Playwright يعمل: المحددات (locators)، والانتظار، واعتراض الشبكة، والمزيد. Capium يستبدل النواة فقط بنواة Chrome حقيقية ومحصّنة.

playwright.py
from capiumbrowser import launch_context

browser, ctx, page = launch_context(seed=200123, humanize=True)

page.goto("https://example.com/login")
page.fill("#email", "[email protected]")
page.fill("#password", "hunter2")
page.click("button[type=submit]")
page.wait_for_url("**/dashboard")

# The Playwright API you already know: locators, waits, network, etc.
print(page.locator("h1").inner_text())
browser.close()

4. Async API

تحاكي الواجهة غير المتزامنة الواجهة المتزامنة: تُرجع launch_context_async الثلاثي نفسه (browser وcontext وpage) مع دوال Playwright قابلة للانتظار.

async_run.py
import asyncio
from capiumbrowser import launch_context_async

async def main():
    browser, ctx, page = await launch_context_async(
        seed=200123, humanize=True, url="https://example.com",
    )
    print(await page.title())
    await browser.close()

asyncio.run(main())

5. وضع Humanize

يؤدي تمرير humanize=True عند التشغيل إلى إضافة إدخال وتوقيت يشبهان الإنسان: حركة فأرة طبيعية، وإيقاع كتابة واقعي، وتوقفات قصيرة متغيرة، إلى جانب الدالتين المساعدتين page.human_type وpage.human_scroll. اتركه مفعّلًا للمسارات التفاعلية، وعطّله لعمليات الجلب والتحليل البحتة حيث تهم السرعة.

humanize.py
browser, ctx, page = launch_context(seed=200123, humanize=True)

page.human_type("#email", "[email protected]")   # natural typing cadence
page.human_scroll(1200)                          # smooth, variable scrolling

6. الجلسات والتزامن

كل متصفح نشط هو جلسة واحدة. حد الجلسات في خطتك هو عدد الجلسات التي يمكنك تشغيلها في الوقت نفسه. أغلق المتصفح عند الانتهاء لتحرير الجلسة.

concurrent.py
import concurrent.futures
from capiumbrowser import launch_context

def fetch(url, seed):
    browser, ctx, page = launch_context(seed=seed, url=url)
    title = page.title()
    browser.close()
    return title

# Each live browser counts as one session against your plan's cap.
urls = ["https://a.example", "https://b.example", "https://c.example"]
seeds = range(200001, 200001 + len(urls))   # one coherent device per worker
with concurrent.futures.ThreadPoolExecutor(max_workers=3) as pool:
    print(list(pool.map(fetch, urls, seeds)))

7. وصفات: لقطات الشاشة وملفات PDF

capture.py
page.goto("https://example.com")

# Full-page screenshot
page.screenshot(path="shot.png", full_page=True)

# Render the page to a PDF
page.pdf(path="page.pdf", format="A4")

8. المنصات وCI

تتوفر ملفات تنفيذية أصلية لأنظمة Linux وWindows وmacOS، بسلوك مطابق على حاسوبك المحمول وخادم CI وأسطولك. في CI، عيّن مفتاح الترخيص كمتغير بيئة سري:

ci.yml
# GitHub Actions / GitLab CI
env:
  CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}

9. استكشاف الأخطاء وإصلاحها

ترخيص غير صالح أو منتهي الصلاحية

تأكد من أن المفتاح يطابق ما في لوحة التحكم وأن ترخيصك (أو تجربتك) لا يزال نشطًا. أعد إصدار المفتاح عند الحاجة.

تم بلوغ حد الجلسات

لديك العدد الأقصى من المتصفحات النشطة الذي تسمح به خطتك. أغلق المتصفحات المنتهية، أو قم بالترقية للحصول على حد جلسات أعلى.

الملف التنفيذي لا يُنزَّل

يُجلب الملف التنفيذي عند التشغيل الأول؛ اسمح باتصالات HTTPS الصادرة. في بيئات CI المقيّدة، خزّن مجموعة الأدوات مؤقتًا بين عمليات التشغيل.

10. الأسئلة الشائعة

أين مفتاح الترخيص الخاص بي؟›

في لوحة التحكم ضمن Capium Browser. يمكنك إظهاره أو نسخه أو إعادة إصداره هناك. احتفظ به سرًا، وتعامل معه ككلمة مرور.

هل أحتاج إلى تنزيل أي شيء يدويًا؟›

لا. تجلب مجموعة الأدوات أحدث ملف تنفيذي محصّن لنظام تشغيلك عند التشغيل الأول وتبقيه محدّثًا تلقائيًا.

ما اللغات والمشغّلات المدعومة؟›

Python هي اللغة الأساسية، وتتحكم فيها عبر واجهة Playwright القياسية التي تستخدمها بالفعل. وتُثبَّت حزمة JavaScript/TypeScript باسم capiumbrowser على npm.

ما الذي يُحتسب جلسة؟›

نسخة متصفح نشطة واحدة. حد الجلسات في خطتك هو العدد الذي يمكنك تشغيله في وقت واحد، وليس إجماليًا شهريًا.

هل تنتهي صلاحية التجربة المجانية؟›

نعم. تمنحك التجربة جلسة متصفح واحدة لمدة 30 يومًا، ثم تنتهي. يمكنك الترقية في أي وقت لمزيد من الجلسات والدعم.

هل أنت مستعد للبدء؟

احصل على مفتاح الترخيص وشغّل أول جلسة خفية خلال دقائق.

افتح لوحة التحكم