KlickyMart

KlickyMart

KlickyMart は、ソフトウェアエージェント向けのオンラインストアの公開署名付きマップです。エージェントがストアにアクセスできるか、チェックアウトがどのように機能するか、ストアがどの支払い方法に対応しているかを掲載し、Bitcoin とプライバシーに配慮した Bitcoin の選択肢に重点を置いています。記録は Nostr イベントとして公開されます（NIP-DRAFT.md を参照）。FloppyKit プロジェクトです。

ステータス：ドラフトです。このリポジトリでは、クロールデータはまだ公開されていません。

内容

• NIP-DRAFT.md：ディレクトリと支払いハンドシェイク用のドラフトイベント種別です。
• CRAWL-RUBRIC.md：記録スキーマと評価ルールです（v0.3 のドラフト変更は末尾にあります）。
• CASCADE.md：構築計画です。
• crawler/：Playwright クローラー（crawl.py）、決定的な支払い情報抽出ツール（extract.py）、利用規約チェッカー（tos.py）、署名ヘルパー、テストです。
• crawler/KNOWN-LIMITATIONS.md：既知の制限事項です。
• site/bot/index.html：クローラーの説明とオプトアウトのページです。https://klickymart.com/bot で配信されます。

クローラーのガードレール

• 正直なユーザーエージェント：FloppyKitMapBot/0.2 (+https://klickymart.com/bot)。ステルスプラグインやフィンガープリントの変更、プロキシ、IP ローテーションは使用しません。
• まず robots.txt を読み込みます。エラー、401、403、またはタイムアウトが発生した場合、サイト全体をクロール禁止として扱います。
• サイトの利用規約で自動アクセスが禁止されている場合、そのサイトはクロールしません。その確認結果のみを、引用と URL を添えて記録します。
• 公開ページのみを対象とします。ログイン、アカウント、注文、支払い情報、カートへの追加を超えるフォーム送信、CAPTCHA の解決は行いません。ブロックは確認結果として記録します。
• リクエスト間は最低 2 秒空け、1 サイトあたり最大 10 ページまでとします。
• 顧客レビュー、Q&A、コメントは根拠として一切使用しません。記録内のすべての支払い方法には引用と URL を付けます。不明な項目は null のままにします。

オプトアウトするには、robots.txt に User-agent: FloppyKitMapBot / Disallow: / を追加してください。詳細：https://klickymart.com/bot

テストの実行

cd crawler
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt && python -m playwright install chromium
python -m unittest discover -s tests -v

テストでは合成フィクスチャを使用し、ネットワークリクエストは行いません。

ライセンス

要確認（FOSS ライセンスを予定していますが、現時点では付与されていません）。