無料GitHub で公開日本語紹介

brightdata-local-dev-loop

Bright Data連携の開発を固定データ中心で進め、解析やエラー処理を通信なしで試せる環境と、明示的に制御するライブテストを整えます。

原文原文の説明を見る

Build a local Bright Data development loop that defaults to synthetic fixtures and makes live traffic explicit. Use when implementing parsers, retry classification, or snapshot handling without spending credits or collecting data. Trigger with: "mock Bright Data locally", "test a Bright Data adapter offline", "add a safe live-test switch".

jeremylongshore/tons-of-skills-marketplaceスター 2,884(GitHub 2,884 + cccskills 0)

実行スコア未検証

インストール方法を見る

こんなときに便利

解析処理を固定データで試したいとき
再試行の判定を通信なしで確認
ライブテストを明示的に制御

日本語での紹介

できること

Bright Data連携の通信処理とデータ解析を分け、通常の開発では固定データを使うテスト環境を整えます。成功応答や407、403、429、処理中・完了・失敗・空・期限切れの状態を含むデータで、パーサーや再試行の判定を確認します。ライブテストは既定で無効にし、環境変数、許可対象の一覧、費用上限という複数の条件を満たす場合だけ実行できるようにします。

こんなときに便利

Bright Dataのアダプターやパーサーを、実データの収集やクレジット消費なしで開発したいときに向いています。テストが意図せずネットワークへ接続していないか、固定データがライブ取得内容に置き換わらないかを確認する用途にも使えます。

使い方の例

「Bright Dataの応答を使わずにパーサーをテストして」
「スナップショットの状態別fixtureを用意して」
「承認対象と予算上限を使うライブテストの切替を追加して」

注意点

ライブテストには承認済みのBright Dataアカウントまたは保護環境、許可された公開データの収集目的が必要です。

この紹介文は、公開されている SKILL.md をもとに AI（OpenAI Codex）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（2）

SKILL.md3.6 KB
references/official-docs.md719 B

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Bright Data Local Fixture Loop

Overview

Separate transport from parsing so ordinary development is deterministic and credential-free. The live lane is opt-in, target-allowlisted, budgeted, and incapable of silently replacing fixtures.

Prerequisites

A repository-owned Bright Data adapter boundary
Synthetic or approved redacted fixtures with expected schemas
A test runner and a protected live-test environment

Instructions

Step 1: Map the boundary

Read the adapter and Grep for direct proxy/API calls in business logic. Move transport behind a narrow interface before recording fixtures.

Step 2: Create explicit modes

Write configuration with fixture as the default and live requiring three independent gates.

brightdata:
  mode: fixture
  live_requires:
    - BRIGHTDATA_LIVE_TEST=1
    - approved_target_manifest
    - bounded_cost_budget

Step 3: Test contract behavior

Add fixtures for success, 407, policy 403, 429, building, ready, failed, empty, and expired states. Test parsers against provider fields rather than copied HTML.

Step 4: Run the loop

Use Bash(npm:*) for unit and contract tests. Permit the live suite only in a protected environment, against an approved target, with a one-job ceiling and redacted receipt.

Tool Discipline

Use Read and Grep for discovery. Use Write and Edit only for the adapter, fixtures, tests, and documented configuration. Use Bash(npm:*) for the named local suites; never let a default test command send live Bright Data traffic.

Output

A fixture-first transport adapter
Deterministic success and failure fixtures
A separately gated live-test receipt and explicit budget

Examples

A parser change should pass against a synthetic snapshot and recorded provider-error metadata with no credentials present. A maintainer may later enable one protected live job; its output updates no fixture automatically and is reviewed before adoption.

Error Handling

Failure	Meaning	Response
Unit tests attempt network access	Transport leaked into parsing code	Block network and refactor through the adapter
Fixture contains target data	Captured live content was committed	Remove it and replace it with synthetic minimal data
Live gate has only one switch	Accidental execution remains possible	Require environment, target manifest, and budget gates

Resources

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

同じリポジトリのスキル