steel-developer

Steel Developer

スキルの適用範囲

• ユーザーが、後で実行するコードや実装のガイダンスを求めている場合に、このスキルを使用します。
• ユーザーが、今すぐエージェントに閲覧、抽出、スクリーンショットの撮影、PDF の作成、またはフォームへの入力を求めている場合は、このスキルを使用しないでください。steel-browser を使用します。
• 主なタスクがセッション失敗の診断である場合は、steel-session-debugging を使用します。
• 主なタスクがボット検出、プロキシ、CAPTCHA、ID、アクセス間隔、またはログインの信頼性対策である場合は、steel-reliability を使用します。

ニーズに応じた参照先

コードを書く前に、関連するリファレンスを読み込んでください。

• CLI のセットアップとローカルでの検証：references/cli-setup.md
• TypeScript、JavaScript、Node.js、Playwright、Puppeteer、Stagehand：references/typescript.md
• Python、Playwright Python、Browser Use：references/python.md
• ファーストパーティ API、正確なドキュメント／API／SDK の確認、ブラウザツール、ファイル、拡張機能、認証コンテキスト、埋め込み、トレース、モバイルモード、マルチリージョン：references/apis.md
• フレームワークの選択、Stagehand、Browser Use、型付きエージェントフレームワーク、コーディングエージェントとの連携：references/ecosystem.md
• 避けるべき古い SDK／API のパターン：references/anti-patterns.md
• コンピューター操作のループ：references/computer-use.md
• ライブおよび過去のセッションの埋め込み：references/live-embed.md
• 信頼性の適用範囲と引き継ぎ：references/reliability-handoff.md

必ず守ること

• 認証用環境変数は STEEL_API_KEY です。
• Node の例では steel-sdk から Steel をインポートします。SDK のソースは steel-dev/steel-node です。
• Node SDK のコンストラクターでは steelAPIKey を使用します。
• Python SDK のコンストラクターでは steel_api_key を使用します。
• クリーンアップ時には必ずセッションを解放してください。
• CDP URL は wss://connect.steel.dev?apiKey=...&sessionId=... の形式で明示的に構築してください。
• 接続後はデフォルトのブラウザーコンテキストを再利用してください。ユーザーが分離を明示的に必要としている場合を除き、新しいコンテキストを作成しないでください。
• 対象サイトの認証情報を、プロンプト、コードコメント、ページスクリプト、ログに含めないでください。
• 正確な API フィールドや SDK メソッドのシグネチャを確認するには、API リファレンス、SDK ドキュメント、ローカルにインストールされた型定義、または curl -sSfL を使って Steel のドキュメントを確認してください。
• references/anti-patterns.md に記載されている古いパターンは絶対に使用しないでください。

最小限のセッション構成

TypeScript：

const steelAPIKey = process.env.STEEL_API_KEY;
if (!steelAPIKey) throw new Error("STEEL_API_KEY is required");

const client = new Steel({ steelAPIKey });
const session = await client.sessions.create();
const cdpUrl = `wss://connect.steel.dev?apiKey=${steelAPIKey}&sessionId=${session.id}`;
const browser = await chromium.connectOverCDP(cdpUrl);
const context = browser.contexts()[0];
const page = context.pages()[0] ?? (await context.newPage());

try {
  await page.goto("https://example.com");
} finally {
  await browser.close();
  await client.sessions.release(session.id);
}

Python：

steel_api_key = os.environ["STEEL_API_KEY"]
client = Steel(steel_api_key=steel_api_key)
session = client.sessions.create()
cdp_url = f"wss://connect.steel.dev?apiKey={steel_api_key}&sessionId={session.id}"
browser = await playwright.chromium.connect_over_cdp(cdp_url)
context = browser.contexts[0]
page = context.pages[0] if context.pages else await context.new_page()
try:
    await page.goto("https://example.com")
finally:
    await browser.close()
    await playwright.stop()
    client.sessions.release(session.id)

セットアップの検証

steel --version
steel login
steel doctor --preflight
steel skills doctor

信頼できる情報源へのリンク

• API リファレンス：https://steel.apidocumentation.com/api-reference
• Node SDK／型定義：https://github.com/steel-dev/steel-node
• Python SDK／型定義：https://github.com/steel-dev/steel-python
• ドキュメントのインデックス：curl -sSfL https://docs.steel.dev/llms.txt
• ドキュメントの完全版バンドル：curl -sSfL https://docs.steel.dev/llms-full.txt
• 個別のドキュメントページ：curl -sSfL https://docs.steel.dev/llms.mdx/<page-path>