zenn-topic-suggester

Zennに記事を投稿するときに設定できるトピックについて、記事の内容に合わせて最適なものを提案するCLIツールです。

概要

Zennに記事を投稿するとき、トピックを最大で5つ設定できます。
ただ、トピックとして何が存在しているのかどうかを調べるのは少し手間がかかります。

また、あるトピックの投稿数が少ない場合、そのトピックに紐づけても関心を持つ人は少ないことが想定されます。

そこでzenn-topic-suggesterでは、直近半年でトピックに投稿された記事数のデータを利用し、直近半年で盛り上がっていて、かつ記事の内容にあうトピックを提案します。

直近半年でトピックに投稿された記事数のデータは、適宜更新していく予定です。

インストール方法

以下のコマンドを実行します。Pythonのバージョンを3.12以降にする必要があることに注意してください。

pip install zenn-topic-suggester

使い方

zenn-topic-suggest path/to/article.mdのように実行します。
以下のように、推奨トピックがスコアの降順で出力されます。 スコアは現在、類似度と記事数の対数をもとに計算していますが、改善していく予定です。

- javascript           # スコア: 0.95, 類似度: 1.00, 直近半年の記事数: 767
- githubactions        # スコア: 0.93, 類似度: 1.00, 直近半年の記事数: 487
- postgresql           # スコア: 0.90, 類似度: 0.98, 直近半年の記事数: 284
- typescript           # スコア: 0.90, 類似度: 0.93, 直近半年の記事数: 1536
- 開発環境                 # スコア: 0.90, 類似度: 0.99, 直近半年の記事数: 122
...

行数を変更したいときはzenn-topic-suggest path/to/article.md -n 50のように指定して、提示されるトピックの数を変更できます。デフォルトは20です。
初めて実行するときに自然言語処理モデルのダウンロードが行われるので、少し実行に時間がかかります。