BotKit by Fedify：誰でも簡単に作れるActivityPubボット

BotKit by Fedifyの紹介資料です。

BotKitは、ActivityPubボットを簡単に作ることができるTypeScriptフレームワークです。従来のMastodon・Misskey APIを使ったボットとは異なり、ActivityPubを直接実装する独立型ボットを数行のコードで作成できます。

OSC 2025 京都での発表資料として作成しました。

🔗 ドキュメント：https://botkit.fedify.dev/
🔗 ソースコード：https://github.com/fedify-dev/botkit

Transcript

1. ߑ
   ຽጣ ϗϯ ϛϯ ώ #PU,JU
   CZ
   'FEJGZ ୭Ͱ΋؆୯ʹ࡞ΕΔ"DUJWJUZ1VCϘοτ
2. ߑ
   ຽጣ ϗϯ ϛϯ ώ w ؖࠃι΢ϧग़਎
   w ϑΣσΟόʔεؔ࿈ͷιϑτ΢ΣΞΛ੍࡞
   w 'FEJGZ
   
   
   
   
   
   
   
   )PMMP
   
   
   
   
   
   
   
   
   #PU,JU
   
   
   
   
   
   
   
   
   )BDLFST
   1VC
   w ೔ຊޠ͸·ͩษڧதͳͷͰɺΑΖ͓͘͠ئ͍͠·͢
   w (JU)VCɿ!EBIMJB
   w ϑΣσΟόʔεɿ!IPOHNJOIFF!IPMMPTPDJBM
   
   !IPOHNJOIFF!IBDLFSTQVC
3. "DUJWJUZ1VCϘοτ։ൃͷ೉͠͞ w ෳࡶͳ"DUJWJUZ1VCϓϩτίϧͷཧղ͕ඞཁ
   w αʔόʔઃఆ΍ೝূɺΩʔ؅ཧͳͲ໘౗ͳ४උ࡞ۀ
   w ʮ؆୯ͳϘοτҰͭ࡞Δ͚ͩͳͷʹʜʯ
   w ΋ͬͱखܰͳํ๏͸ͳ͍ͩΖ͏͔ʁ
4. #PU,JUͱ͸ʁ w ಠཱܕ"DUJWJUZ1VCϘοτϑϨʔϜϫʔΫ
   w 5ZQF4DSJQUج൫
   w "DUJWJUZ1VCαʔόʔ࣮૷ϑϨʔϜϫʔΫͰ͋Δ'FEJGZͷ࢞ຓϓϩδΣΫτ
   w .BTUPEPOɾ.JTTLFZɾ1MFSPNB౳͢΂ͯͷϑΣσΟόʔεϓϥοτϑΥʔϜͱޓ׵
   w ௚ײతͰ؆୯ͳ"1*
   w ݱࡏ%FOPରԠɺWͰ/PEFKT΋ରԠ༧ఆ
5. ैདྷͷํ๏
   WT
   #PU,JU w ैདྷͷํ๏ɿ
   w #PU,JUɿ ϑΣσΟόʔε .BTUPEPO.JTTLFZ Ϙοτ "DUJWJUZ1VC "1* ϑΣσΟόʔε #PU,JUͷϘοτ "DUJWJUZ1VC
6. ैདྷͷํ๏
   WT
   #PU,JU Կ͕ҧ͏ͷ͔ w ௚઀ͭͳ͕Δɿ"1*੍ݶͳ͠Ͱ"DUJWJUZ1VCͱ௚઀΍ΓͱΓ
   w ׬શʹಠཱɿΠϯελϯεͷϧʔϧ΍ϓϥοτϑΥʔϜͷ੍໿ʹറΒΕͳ͍
   w ։ൃָ͕ɿ໘౗ͳೝূͳ͠Ͱ਺ߦͷίʔυͰ׬੒
7. #PU,JUͰग़དྷΔ͜ͱ w ϝοηʔδɿ౤ߘɺίϝϯτɾฦ৴ɺҾ༻ɺฤूɾ࡟আ
   w ΍ΓऔΓɿ͍͍ͶΛૹͬͨΓड͚ͨΓɺֆจࣈϦΞΫγϣϯɺγΣΞɾϒʔετ
   w ϑΥϩʔɿϑΥϩʔɾΞϯϑΥϩʔɺϦΫΤετͷঝೝɾڋ൱
   w ΧελϜֆจࣈɺը૾ɾಈըఴ෇ɺ͍Ζ͍Ζͳެ։ൣғ
   w ΞϯέʔτʢW͔Βʣɺ΢Σϒ࿈ܞɺεέδϡʔϦϯά
8. جຊϘοτ࡞੒ ʢ෼Ͱʂʣ import { createBot, text } from "@fedify/botkit"; const bot = createBot<void>({ username: "greetbot", name: "ѫࡰϘοτ", summary: text`ͥΥͽͳ΁ĈBotKit͹ᥭ͵ͱϡψύ͹ͫg`, kv: new MemoryKvStore(), }); export default bot; / / deno serve͹࣮ͫ͢ḝĈ
9. Πϕϯτॲཧ / / Ϛήϲ ー ͧΞͱᙉ΀ରԠ bot.onFollow = async (session, followRequest) = > { await followRequest.accept(); await session.publish( text`Ϛήϲ ー ͔Μ͞ͺ͖ͦͨ͘ΐͫf${followRequest.follower}ͧΥĈ`, { visibility: "direct" } ); }; / / ϦϸμϬϸͧΞͱᙉ΀ରԠ bot.onMention = async (session, message) = > { await message.like(); await message.reply(text`ͥΥͽͳ΁f${message.actor}ͧΥĈ`); };
10. #PU,JUͰૹड৴Ͱ͖ΔΠϯλϥΫγϣϯҰཡ #PU,JUͰ΍ΓऔΓͰ͖ΔΠϯλϥΫγϣϯ͸ɺ࣍ͷͱ͓ΓͰ͢ Πϕϯτϋϯυϥʔ ϝιου Bot.onFollow Session.follow() Bot.onUnfollow Session.unfollow() Bot.onAcceptFollow FollowRequest.accept() Bot.onRejectFollow FollowRequest.reject() Bot.onReply Message.reply() Bot.onQuote Session.publish( . . . , { quoteTarget }) Bot.onMention Session.publish(text`${actor} . . . `)
11. #PU,JUͰૹड৴Ͱ͖ΔΠϯλϥΫγϣϯҰཡ #PU,JUͰ΍ΓऔΓͰ͖ΔΠϯλϥΫγϣϯ͸ɺ࣍ͷͱ͓ΓͰ͢ Πϕϯτϋϯυϥʔ ϝιου Bot.onMessage Session.publish() Bot.onSharedMessage Message.share() Bot.onLike Message.like() Bot.onUnlike AuthorizedLike.unlike() Bot.onReact Message.react() Bot.onUnreact AuthorizedReaction.unreact() Bot.onVote Session.publish( . . . , { poll })
12. ߴ౓ͳػೳ / / ΰξτϥֆየᥙΤᄐ࿥ const emojis = bot.addCustomEmojis({ botkit: { f i le: "./botkit.png", type: "image/png" } }); / / ᨷ࿴ᴬລ + ᥦხᒵ᩹ setInterval(async () = > { const session = bot.getSession("https: / / mybot.com"); const message = await session.publish( text`ຖ࣌ؒ͝ѫࡰʂ ${customEmoji(emojis.botkit)}` ); / / 30᰽ἦͽᥦხᒵ᩹ setTimeout(() = > message.delete(), 30000); }, 1000 * 60 * 60);
13. ͍Ζ͍Ζͳ࢖͍ํɿࠓ͙͢ࢼͤΔྫ IUUQTCPULJUGFEJGZEFWFYBNQMFT w HSFFUUTɿجຊతͳѫࡰϘοτʢϑΥϩʔɾϝϯγϣϯରԠɺఆظ౤ߘʣ
    w PUQUTYɿֆจࣈͱΞϯέʔτΛ࢖ͬͨϫϯλΠϜೝূγεςϜ
    w 'FEJ$IBU#PUɿϑΣσΟόʔεͰಈ͘νϟοτϘοτ
14. #PU,JU
    Ͱ௥Ճ༧ఆ w Ξϯέʔτػೳ
    w /PEFKTରԠ
15. ࢀߟࢿྉ ͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ w υΩϡϝϯτɿCPULJUGFEJGZEFW
    w ιʔείʔυɿHJUIVCDPNGFEJGZEFWCPULJU
    w ެࣜϑΣσΟόʔεɿ!CPULJU!IPMMPTPDJBM
    w ൃදࢿྉɿCJUMZPTDLZPUPCPULJU