はじめに

Paprika を使い始めます。インストールから最初のスクリプトまで 5 分です。

Paprika の動かし方

Paprika は 2 つの部分に分かれます。役割を分けて考えると分かりやすいです。

本体を触らずに試すだけなら 管理画面（ブラウザだけで URL を投げて収集）から始めるのが一番手軽です。 このページは、稼働中のハブに対して スクリプトから操作する 人向けです。

SDK をインストール

必要なのは Python 3.10+ と、稼働中ハブへの到達性だけ（依存は httpx のみ）。

# ソースツリーから
pip install -e ./client/python

# または直接
pip install "git+https://github.com/paps-jp/paprika.git#subdirectory=client/python"

ハブに接続

接続先は 引数 → 環境変数 PAPRIKA_HUB → http://localhost:8000 の順で解決されます。 引数なしの connect() にしておくと、ローカルでもサンドボックス内でも同じスクリプトが動きます。

export PAPRIKA_HUB=http://paprika.lan:8000

import asyncio
from paprika_client import async_paprika

async def main():
    async with async_paprika.connect() as cli:   # PAPRIKA_HUB を自動参照
        print(await cli.health())

asyncio.run(main())

最初のスクリプト

ページを開いてタイトルとリンクを取得する：

import asyncio
from paprika_client import async_paprika

async def main():
    async with async_paprika.connect() as cli:
        async with cli.session("https://news.ycombinator.com") as page:
            print(await page.title())
            for url in await page.links(urls_only=True):
                print(url)

asyncio.run(main())

async with cli.session(url) がブラウザのタブを 1 つ確保し、ブロックを抜けると自動で閉じます。 操作 API は Playwright とほぼ同じ（goto / click / fill / evaluate …）。一覧は API リファレンス。

コア概念

ジョブモード

ジョブ投入時に mode を選びます。

2 つの取得経路

「画像を取得する」には用途の違う 2 つの入口があります。混同しないようご注意ください。

次のステップ