About the Hakumei user agent

If you found Hakumei/1.0 (+https://hakumei.app) in your server logs, this page explains what it is and how to control it.

What Hakumei is

Hakumei is a desktop application for macOS, currently in development. It lets an individual user collect reference images from architecture and design publications that the user chooses to follow, and organize them on their own computer for personal reference.

Hakumei is not a centralized crawler. Requests are made from individual users' computers, at their initiative or on schedules they configure. There is no central index, nothing is republished, and collected content stays on the user's machine. While the software is in development, requests with this user agent originate from the developer's own testing.

Built-in politeness

• An honest, identifiable user agent — Hakumei/1.0 (+https://hakumei.app) — instead of a disguised browser string.
• Article discovery (crawling) honors robots.txt. Fetching of images, subscribed feeds and public APIs is performed in the manner of a normal browser or feed reader request.
• A minimum interval between requests to the same host.
• Automatic, persistent backoff when a host responds with 429 or 403.

How to control or stop it

• Disallow the Hakumei user agent in your robots.txt — article discovery will comply.
• Responding with 429 or 403 causes the software to back off from your host automatically.
• Or simply write to us: [email protected]. We will look into what can be addressed on the software side.

---

クローラ・収集について

サーバーのログに Hakumei/1.0 (+https://hakumei.app) というユーザーエージェントが記録されていた場合のご案内です。

Hakumei とは

Hakumei は、現在開発中の macOS 用デスクトップアプリケーションです。利用者が自分で選んだ建築・デザインメディアから参考画像を取り込み、自分のコンピューター上で個人の参考のために整理するための道具です。

Hakumei は集中型のクローラではありません。アクセスは各利用者のコンピューターから、利用者自身の操作または利用者が設定したスケジュールによって行われます。中央のインデックスは存在せず、収集された内容が再公開されることもありません。開発中の現在、このユーザーエージェントによるアクセスは開発者自身のテストによるものです。

組み込みの配慮

• ブラウザを偽装せず、正直に名乗るユーザーエージェント。
• 記事の探索（クロール）は robots.txt に従います。画像・購読フィード・公開 API の取得は、通常のブラウザやフィードリーダーと同様の扱いで行います。
• 同一ホストへのアクセスには最小間隔を設けています。
• 429 / 403 応答を受けたホストへは、自動的にアクセスを控えます（バックオフ）。

停止・制御の方法

• robots.txt で User-agent: Hakumei を Disallow に指定してください。記事の探索はこれに従います。
• 429 / 403 を返していただければ、ソフトウェアは自動的にそのホストへのアクセスを控えます。
• メールでのご連絡も受け付けています: [email protected]。ソフトウェア側でできる対応を検討します。