ツイッター（X）が API 制約を含めて色々と不便になってしばらく経過しました。ツイッターでリツイートボットとか作ってた個人のものはほぼ全滅状態ですが、さすがに「しばらく待てばまた使えるようになる、、」などと楽観的には考えない方が良さそうな感じですね。
世の中には使いにくくなったツイッターの後釜を狙う SNS も多く出てきましたが、今のところはまだツイッターを使っている人が圧倒的多数の印象です。まあ開発者的にはツイッターはもう見限ってる人も少なくないんでしょうけど、SNS はあくまで「発信の場」であって、使っているのは開発者ばかりじゃないですからね。メッセージを届ける先の規模含めると、使い勝手が現状維持ならまだしばらくツイッターが使われていくのでしょう。
一方で、とはいえ多くの SNS が新たに生まれてきてはいます。実は自分も「お絵描き SNS」という位置づけの MyDoodles なんていうものを密かにリリースしていたりもするのですが、、、そんな中でツイッターの共同創業者の一人だったジャック・ドーシーさんが新たに立ち上げた分散型 SNS である Bluesky Social （以下 "Bluesky"）はツイッターに似たインターフェースを持ち、リリースからしばらくは招待制で運用されていましたが、先ごろ招待制が撤廃されて誰でもアカウントを作れるようになりました。比較的早い段階から API も公開されており、開発者視点では「次に来るのはこれかも」と期待しています。
そんな Bluesky の API を使って、ツイッターでは（個人では事実上）作れなくなってしまったボットを作ってみることにしました。自分が作ろうと思ったのは拙作マンホールマップが持つ機能の１つである「今日のマンホール」を午前零時に自動でつぶやくボットです。実はこれまでは私自身が人間ボットになって（笑）今日のマンホールを手動でつぶやいていたのですが、これを Bluesky 内で自動化する、というものです。ボットとしての基本的な考え方はツイッターの頃と大きく変わるものではないのですが、分散 SNS である Bluesky の、まだ充分に熟しているとは言えない API を使って実装することはチャレンジでもあり、色々面倒な考慮も必要にはなるのですが、とりあえず作れそうだったので、その中身の解説をするのが本ブログエントリの目的です。なお以下で紹介する内容は 2024-02-12 時点の情報であることをご了承ください。
【開発環境】
まず Bluesky API を紹介している本家ページがこちらです：
https://www.docs.bsky.app/docs/get-started
SDK としては Node.js と Python 向けに提供されているようですが、Curl からも使える REST API があるようなので REST API でプログラミングするつもりであれば事実上プログラミング言語に制約はないことになります。今回以下で紹介するプログラミングの環境としては自分が普段使っている Node.js を使うことにします。
Node.js の場合、@atproto/api というライブラリを使うことで比較的簡単に Bluesky API を使ったアプリケーションの開発ができるようになります。こんな感じでインストールして使います：
【認証】
Bluesky API を使って試しに自分自身の情報でも取得・・・ するのもいいですが、まずは認証を行う必要があります。ツイッターなどでは開発者向けページからアプリケーションを登録して API キーを発行して OAuth 2.0 で・・・ といった手順で認証を行っていました。Bluesky もいずれはそのような形態になるものと思いますが、現時点では OAuth2.0 はサポートされておらず、ユーザー ID とパスワードを使って直接ログインする形になるようです。ちょうど Bluesky の招待制も終わったことなので、自分はこのボット用（というかマンホールマップ用）のアカウントを１つ新たに作成しました。そして Node.js の場合はこのような形で認証（ログイン）を行います：
"@atoproto/api" ライブラリから BskyAgent をインポートして、メールアドレス（上では "myname@email.com" の部分）とパスワード（同 "mypassword" 部分）を指定してログインします。このあたりはソースコード内に直接記載するのは危険なので、コードの管理方法には注意が必要です。
【ツイートする】
ボットを作るには「ツイートする」（書き込む）機能が必要です。ログイン後に単にテキストをツイートするだけなら簡単です。特に @atproto/api ライブラリを使っていれば post メソッドを使って以下のようにログイン後の処理を一行追加するだけです：
これでログインしたユーザーの権限で "Hello, world." とつぶやくことができます。簡単ですよね、ここまでは。
【facets 処理（リッチテキスト処理）】
テキストをつぶやくのは簡単でした。ツイッターなどではこのテキスト内に他のユーザーへのメンション（@）が含まれていたり、ハッシュタグ（#）やリンクが含まれていると自動的に解釈してリッチテキスト化してくれて（リンクとかを付けてくれて）いましたが、Bluesky API はそうはいきません（そもそも Bluesky にはまだハッシュタグという概念がありません）。この辺りはプログラミング内でリッチテキスト化（Bluesky では「facets 検知」といいます）する必要があります。今回作ろうとしているボットも必ずあるページへのリンクを含む内容になっているので post 実行前の facets 検知が必須です。この辺から少し面倒になってきます。
具体的にはこのようなコードになります：
まずリッチテキスト化処理を行うために @atproto/api ライブラリから BskyAgent だけでなく RichText もインポートしておきます。そしてリンクなどのリッチテキスト化が必要なテキストを RichText で初期化した結果を変数 rt で受け取り、更に detectFacets() 処理を実行します。するとテキスト部分は rt.text に、facets 情報が rt.facets にそれぞれ格納されます。ツイッターではこの辺りの処理が自動化されていたので楽でしたが、Bluesky でもここまでライブラリが用意されているのでさほど大変ではないですね。
最後に facets 処理した結果を post します。先のプレーンテキストでは text 要素だけを post していましたが、リッチテキストの場合は少し情報を加えてあげる必要がありますが、これでテキスト内の URL 部分はリンクになってポストされます。
【オープングラフ処理（OGP対応）】
ツイッターなど多くの SNS ではリンクを含む情報をポストすると、そのリンク先の内容の一部（テキストや画像）が埋め込まれる形で表示されます。これは OGP と呼ばれる規格で、リンク先が OCP 規格に沿って作られたページであれば、その情報を使って実現できるものです。
Bluesky の場合もリンク先の情報を埋め込むことはできるのですが、API でつぶやく場合は（現状では）この部分を全て手作業で行う必要があります。具体的にはこんな感じです：
まず URL のリンク先情報を解析するために node-html-parser ライブラリをインポートしておきます。そしてリンク先の URL（上では "https://manholemap.juge.me/"）を fetch して HTML を取得します。OGP の規格に沿って作られたページであれば、その画像は HTML 内で <meta property="og:image" content="＊＊＊" /> の ＊＊＊ 部分に指定されることになっているのでその値を取り出します。そして再度その画像 URL を fetch してバイナリデータを取り出し、agent 変数を使ってアップロードします。そのアップロード結果の情報等を使って OGP の埋め込みデータ（embed_params 変数）を作成します。埋め込みデータを作ることができたら、その値を embed パラメータに加えて post する、という流れになります。これで OGP に対応したポスト処理を Node.js で行うことができるようになりました。
【サンプルソースコード公開】
後はこの実行を自動化することになりますが、今回は自分が使っているサーバーの crontab を使って日本時間の午前零時ちょうどに実行するようにしました。具体的なコードは後述しますが、大まかには、
（１）日本時間午前零時になったら、マンホールマップの「今日のマンホール」取得 API を呼び出し、
（２）その結果からリンク先 URL やポストするテキストを生成し、
（３）リンク先 URL の OGP 情報を使って画像やタイトルなどを取り出して、埋め込み、
（４）facets 処理を加えた上でポストする
という流れを行っています。そしてそのサンプルソースコードを以下で公開しています：
https://github.com/dotnsf/bsky_manhotalk_bot/blob/main/motd.js
上では解説していない部分を１点だけ。上述のように現状の Bluesky API は認証情報を ID とパスワードを直接指定する形で実行する必要があります。上のリンク先を見るとわかるのですが、今回公開したサンプルソースコードには ID やパスワードは含まれておらず、このソースコードを実行する際の環境変数から取得するようにしています。したがってこのソースコードを実行する時に、
といった具合に BSKY_ID 環境変数と BSKY_PW 環境変数にそれぞれ Bluesky へのログイン ID とパスワードを指定して実行することで正しく動くようにしています。
そうして作ったマンホールマップ・ボットはこちらのアカウントで公開しています：
https://bsky.app/profile/manholemap.bsky.social
↑ツイッターとちがって Bluesky のアカウントを持っていない人でも見ることはできますが、可能であればアカウントを作ってフォローしてください。「今日のマンホール」が登録されている日全てで午前零時になると教えてくれます（登録されていない日もあります）。
とりあえず現時点では「今日のマンホール」専用で動くボットですが、いずれハッシュタグが実装されたら #manhotalk ハッシュタグを検索して・・といった挙動や、ちょっとした会話にも挑戦するつもりでいます。
世の中には使いにくくなったツイッターの後釜を狙う SNS も多く出てきましたが、今のところはまだツイッターを使っている人が圧倒的多数の印象です。まあ開発者的にはツイッターはもう見限ってる人も少なくないんでしょうけど、SNS はあくまで「発信の場」であって、使っているのは開発者ばかりじゃないですからね。メッセージを届ける先の規模含めると、使い勝手が現状維持ならまだしばらくツイッターが使われていくのでしょう。
一方で、とはいえ多くの SNS が新たに生まれてきてはいます。実は自分も「お絵描き SNS」という位置づけの MyDoodles なんていうものを密かにリリースしていたりもするのですが、、、そんな中でツイッターの共同創業者の一人だったジャック・ドーシーさんが新たに立ち上げた分散型 SNS である Bluesky Social （以下 "Bluesky"）はツイッターに似たインターフェースを持ち、リリースからしばらくは招待制で運用されていましたが、先ごろ招待制が撤廃されて誰でもアカウントを作れるようになりました。比較的早い段階から API も公開されており、開発者視点では「次に来るのはこれかも」と期待しています。
そんな Bluesky の API を使って、ツイッターでは（個人では事実上）作れなくなってしまったボットを作ってみることにしました。自分が作ろうと思ったのは拙作マンホールマップが持つ機能の１つである「今日のマンホール」を午前零時に自動でつぶやくボットです。実はこれまでは私自身が人間ボットになって（笑）今日のマンホールを手動でつぶやいていたのですが、これを Bluesky 内で自動化する、というものです。ボットとしての基本的な考え方はツイッターの頃と大きく変わるものではないのですが、分散 SNS である Bluesky の、まだ充分に熟しているとは言えない API を使って実装することはチャレンジでもあり、色々面倒な考慮も必要にはなるのですが、とりあえず作れそうだったので、その中身の解説をするのが本ブログエントリの目的です。なお以下で紹介する内容は 2024-02-12 時点の情報であることをご了承ください。
【開発環境】
まず Bluesky API を紹介している本家ページがこちらです：
https://www.docs.bsky.app/docs/get-started
SDK としては Node.js と Python 向けに提供されているようですが、Curl からも使える REST API があるようなので REST API でプログラミングするつもりであれば事実上プログラミング言語に制約はないことになります。今回以下で紹介するプログラミングの環境としては自分が普段使っている Node.js を使うことにします。
Node.js の場合、@atproto/api というライブラリを使うことで比較的簡単に Bluesky API を使ったアプリケーションの開発ができるようになります。こんな感じでインストールして使います：
$ npm install @atproto/api
【認証】
Bluesky API を使って試しに自分自身の情報でも取得・・・ するのもいいですが、まずは認証を行う必要があります。ツイッターなどでは開発者向けページからアプリケーションを登録して API キーを発行して OAuth 2.0 で・・・ といった手順で認証を行っていました。Bluesky もいずれはそのような形態になるものと思いますが、現時点では OAuth2.0 はサポートされておらず、ユーザー ID とパスワードを使って直接ログインする形になるようです。ちょうど Bluesky の招待制も終わったことなので、自分はこのボット用（というかマンホールマップ用）のアカウントを１つ新たに作成しました。そして Node.js の場合はこのような形で認証（ログイン）を行います：
var { BskyAgent } = require( '@atproto/api' );
var agent = new BskyAgent({
service: "https://bsky.social"
});
agent.login({
identifier: "myname@email.com",
password: "mypassword",
}).then( async function(){
// ログイン成功後の処理へ
:
:
});
"@atoproto/api" ライブラリから BskyAgent をインポートして、メールアドレス（上では "myname@email.com" の部分）とパスワード（同 "mypassword" 部分）を指定してログインします。このあたりはソースコード内に直接記載するのは危険なので、コードの管理方法には注意が必要です。
【ツイートする】
ボットを作るには「ツイートする」（書き込む）機能が必要です。ログイン後に単にテキストをツイートするだけなら簡単です。特に @atproto/api ライブラリを使っていれば post メソッドを使って以下のようにログイン後の処理を一行追加するだけです：
var { BskyAgent } = require( '@atproto/api' );
var agent = new BskyAgent({
service: "https://bsky.social"
});
agent.login({
identifier: "myname@email.com",
password: "mypassword",
}).then( async function(){
var res = await agent.post( { text: 'Hello, world.'} );
console.log( {res} );
});
これでログインしたユーザーの権限で "Hello, world." とつぶやくことができます。簡単ですよね、ここまでは。
【facets 処理（リッチテキスト処理）】
テキストをつぶやくのは簡単でした。ツイッターなどではこのテキスト内に他のユーザーへのメンション（@）が含まれていたり、ハッシュタグ（#）やリンクが含まれていると自動的に解釈してリッチテキスト化してくれて（リンクとかを付けてくれて）いましたが、Bluesky API はそうはいきません（そもそも Bluesky にはまだハッシュタグという概念がありません）。この辺りはプログラミング内でリッチテキスト化（Bluesky では「facets 検知」といいます）する必要があります。今回作ろうとしているボットも必ずあるページへのリンクを含む内容になっているので post 実行前の facets 検知が必須です。この辺から少し面倒になってきます。
具体的にはこのようなコードになります：
var { BskyAgent, RichText } = require( '@atproto/api' );
var agent = new BskyAgent({
service: "https://bsky.social"
});
agent.login({
identifier: "myname@email.com",
password: "mypassword",
}).then( async function(){
var text = "リンクを含むテキスト https://manholemap.juge.me/";
var rt = new RichText({ text: text });
await rt.detectFacets( agent );
var res = await agent.post({
$type: 'app.bsky.feed.post',
text: rt.text,
facets: rt.facets
});
console.log( {res} );
});
まずリッチテキスト化処理を行うために @atproto/api ライブラリから BskyAgent だけでなく RichText もインポートしておきます。そしてリンクなどのリッチテキスト化が必要なテキストを RichText で初期化した結果を変数 rt で受け取り、更に detectFacets() 処理を実行します。するとテキスト部分は rt.text に、facets 情報が rt.facets にそれぞれ格納されます。ツイッターではこの辺りの処理が自動化されていたので楽でしたが、Bluesky でもここまでライブラリが用意されているのでさほど大変ではないですね。
最後に facets 処理した結果を post します。先のプレーンテキストでは text 要素だけを post していましたが、リッチテキストの場合は少し情報を加えてあげる必要がありますが、これでテキスト内の URL 部分はリンクになってポストされます。
【オープングラフ処理（OGP対応）】
ツイッターなど多くの SNS ではリンクを含む情報をポストすると、そのリンク先の内容の一部（テキストや画像）が埋め込まれる形で表示されます。これは OGP と呼ばれる規格で、リンク先が OCP 規格に沿って作られたページであれば、その情報を使って実現できるものです。
Bluesky の場合もリンク先の情報を埋め込むことはできるのですが、API でつぶやく場合は（現状では）この部分を全て手作業で行う必要があります。具体的にはこんな感じです：
var { BskyAgent, RichText } = require( '@atproto/api' );
var { parse } = require( 'node-html-parser' );
var agent = new BskyAgent({
service: "https://bsky.social"
});
agent.login({
identifier: "myname@email.com",
password: "mypassword",
}).then( async function(){
var text = "リンクを含むテキスト https://manholemap.juge.me/";
//. OGP
var url = "https://manholemap.juge.me/";
var resp = await fetch( url );
var html = parse( await( resp.text() ) );
var title = html.querySelector( "meta[property='og:description']" ).getAttribute( "content" );
//. embed image
var ogpImg = html.querySelector( "meta[property='og:image']" ).getAttribute( "content" );
var blob = await fetch( ogpImg );
var buffer = await blob.arrayBuffer();
var response = await agent.uploadBlob( new Uint8Array( buffer ), { encoding: "image/jpeg" } );
var embed_params = {
$type: "app.bsky.embed.external",
external: {
uri: "https://manholemap.juge.me/",
thumb: {
$type: "blob",
ref: {
$link: response.data.blob.ref.toString()
},
mimeType: response.data.blob.mimeType,
size: response.data.blob.size
},
title: title,
description: title
}
};
var rt = new RichText({ text: text });
await rt.detectFacets( agent );
var res = await agent.post({
$type: 'app.bsky.feed.post',
text: rt.text,
facets: rt.facets,
embed: embed_params
});
console.log( {res} );
});
まず URL のリンク先情報を解析するために node-html-parser ライブラリをインポートしておきます。そしてリンク先の URL（上では "https://manholemap.juge.me/"）を fetch して HTML を取得します。OGP の規格に沿って作られたページであれば、その画像は HTML 内で <meta property="og:image" content="＊＊＊" /> の ＊＊＊ 部分に指定されることになっているのでその値を取り出します。そして再度その画像 URL を fetch してバイナリデータを取り出し、agent 変数を使ってアップロードします。そのアップロード結果の情報等を使って OGP の埋め込みデータ（embed_params 変数）を作成します。埋め込みデータを作ることができたら、その値を embed パラメータに加えて post する、という流れになります。これで OGP に対応したポスト処理を Node.js で行うことができるようになりました。
【サンプルソースコード公開】
後はこの実行を自動化することになりますが、今回は自分が使っているサーバーの crontab を使って日本時間の午前零時ちょうどに実行するようにしました。具体的なコードは後述しますが、大まかには、
（１）日本時間午前零時になったら、マンホールマップの「今日のマンホール」取得 API を呼び出し、
（２）その結果からリンク先 URL やポストするテキストを生成し、
（３）リンク先 URL の OGP 情報を使って画像やタイトルなどを取り出して、埋め込み、
（４）facets 処理を加えた上でポストする
という流れを行っています。そしてそのサンプルソースコードを以下で公開しています：
https://github.com/dotnsf/bsky_manhotalk_bot/blob/main/motd.js
上では解説していない部分を１点だけ。上述のように現状の Bluesky API は認証情報を ID とパスワードを直接指定する形で実行する必要があります。上のリンク先を見るとわかるのですが、今回公開したサンプルソースコードには ID やパスワードは含まれておらず、このソースコードを実行する際の環境変数から取得するようにしています。したがってこのソースコードを実行する時に、
$ BSKY_ID=myname@email.com BSKY_PW=mypassword node motd.js
といった具合に BSKY_ID 環境変数と BSKY_PW 環境変数にそれぞれ Bluesky へのログイン ID とパスワードを指定して実行することで正しく動くようにしています。
そうして作ったマンホールマップ・ボットはこちらのアカウントで公開しています：
https://bsky.app/profile/manholemap.bsky.social
↑ツイッターとちがって Bluesky のアカウントを持っていない人でも見ることはできますが、可能であればアカウントを作ってフォローしてください。「今日のマンホール」が登録されている日全てで午前零時になると教えてくれます（登録されていない日もあります）。
とりあえず現時点では「今日のマンホール」専用で動くボットですが、いずれハッシュタグが実装されたら #manhotalk ハッシュタグを検索して・・といった挙動や、ちょっとした会話にも挑戦するつもりでいます。
