brightdata-web-unlocker

name	brightdata-web-unlocker
description	Bright Data Web Unlocker APIでCAPTCHAやスライダーに止められるページのHTML/Markdownを取得し、 ローカル保存・ローカル表示まで進めるスキル。AliExpressのIPベースブロック回避にも使う。 Use when: 「Bright DataでCAPTCHA回避したい」「Web Unlockerを使いたい」「AliExpressのスライダーを迂回したい」「保護ページのHTMLを取得したい」「cookie注入が効かない」
type	script
languages	["ja","en"]
has_scripts	true

Brightdata Web Unlocker

Bright Dataのサーバー側取得を使って、手元IPでブロックされるページの内容を回収し、file:// で安全に確認する。

Quick Start

cd brightdata-web-unlocker

export BRIGHTDATA_API_KEY="your-api-key"
export BRIGHTDATA_WEB_UNLOCKER_ZONE="your-zone"

node scripts/fetch-unlocked-page.mjs "https://ja.aliexpress.com/item/1005000000000000.html" \
  --country JP \
  --open

ワークフロー

1. scripts/fetch-unlocked-page.mjs で Bright Data Web Unlocker API にURLを投げる。
2. 返ってきたHTML/Markdownを artifacts/ に保存し、必要なら --open でローカル表示する。
3. リモートURLへ同IPで再訪せず、保存済みファイルを確認する。
4. AliExpressで価格の構造化取得が必要なら ali-price-api と併用する。

Safety Rules

• Cookie移植だけで回避しようとしない。IPベースのブロックには効かない。
• ブロック確認後は、同じブラウザIPで元URLへ戻らず、保存済みHTMLを file:// で見る。
• APIキーとzoneはCLI引数より環境変数を優先して扱う。
• 商品ページの確認目的なら、ローカルHTTPサーバーより保存ファイルの直接表示を優先する。

参照ガイド

• 詳細手順とCLI: references/usage.md
• AliExpress向け運用メモ: references/aliexpress.md
• 継続的な学び: references/lessons.md

ワークフロー改善提案

躓いた点があれば、次回は何を references/・scripts/・hooks に逃がすべきかを簡潔に述べること。

継続的改善

エラーや改善点は references/lessons.md に記録し、再発する手作業は scripts/ か hooks に移すこと。