リポジトリを公開したのに、ほとんど誰も使っていない。オープンソース プロジェクトの宣伝に関するアドバイスの大半は、投稿先の一覧と GitHub のスターを増やすコツで、数年前に書かれたものです。その後、スターは簡単に偽装できるようになりました:ICSE 2026 で発表された研究は、GitHub 上の偽のスターの疑いがあるものを約 600 万と推定し、買った人気は約 2 か月以内に薄れることを明らかにしました。このガイドでは、スターの代わりに何をマーケティングするか、どの層から始めるか、GitHub 自身の上限にもとづくリポジトリのチェックリスト、どのチャネルがどんな種類のプロジェクトに合うか、逆効果になる宣伝、30 日間の計画、コピーして使える週ごとのローンチ記録、そしてプロジェクトがスタートアップの一部である場合にユーザーが顧客に変わる流れを扱います。Soloop のアカウントがなくても使えます。
短い答え
オープンソース プロジェクトをマーケティングするには、1 つの問題を抱える 1 種類のユーザーに向けて書き、README とクイックスタートでその人が数分で動く結果にたどり着けるようにし、そのユーザーがすでに話している 1 つの場所でローンチします。そのうえで試してくれた人と話し、つまずいた点を直して、別の場所で再びローンチします。
スターではなく人を測ってください。GitHub は自動化されたスターと有償のエンゲージメントを禁止しており、ICSE 2026 で発表された研究では、偽のスターはプロジェクトに短い後押しを与えた後、長く続く損害をもたらすことがわかりました。誰が訪れ、誰がクローンやインストールをし、誰が Issue を立て、誰が戻ってくるかを追跡し、GitHub が表示する 14 日間のトラフィックを消える前に保存してください。
2026 年にスターが目標として弱い理由
スターはブックマークです。1 クリックで付けられ、その人がプロジェクトを使ったかどうかは何も示さず、買うこともできます。Hao He らの研究チームは、2019 年から 2024 年の間に偽のスターの疑いがあるものを約 600 万と推定し、2024 年に急増したとしています。その大半は短命なマルウェアのリポジトリを宣伝するもので、残りは主に AI と LLM、ブロックチェーン、ツール、チュートリアルのプロジェクトを宣伝していました。宣伝の効果は約 2 か月未満しか続かず、その後、偽のスターは負債になりました。
それでも、スターは公開されたシグナルとして意味を持ちます。投資家やランキングはスターを見ています:Runa Capital の ROSS Index はスターの伸びでオープンソースのスタートアップを順位付けしており、2026 年の第 3 四半期には、掲載されたプロジェクトのほぼすべてが AI またはエージェントのツールでした。スターは、人々がプロジェクトを役立つと感じた結果として遅れて現れるものと考え、最適化する目標にはしないでください。
2019 年から 2024 年に偽のスターの疑いがあるものが約 600 万あり、2024 年に急増した。大半は短命なマルウェアのリポジトリを宣伝し、残りは主に AI/LLM、ブロックチェーン、ツール、チュートリアルのリポジトリを宣伝している。宣伝の効果は約 2 か月未満しか続かず、その後は負債になる。
He et al., Six Million (Suspected) Fake Stars in GitHub (ICSE 2026)不正なインタラクション、自動化されたスターやフォローなどのランキングの悪用、エアドロップなどの報酬で誘導したエンゲージメント、不正な活動の二次市場を禁止している。
GitHub Acceptable Use Policies、セクション 42026 年第 3 四半期の ROSS Index は、GitHub のスターの伸びでオープンソースのスタートアップを順位付けしている。20 件のほぼすべてが AI またはエージェントのプロジェクト。
Runa Capital:ROSS Index Q3 2026最初に誰に向けてマーケティングするかを決める
オープンソース プロジェクトには 3 つの層があり得て、それぞれ必要なものが違います。GitHub のメンテナーのパネルの言い方は単純です:まずユーザーを増やすこと。目に見える利用こそがコントリビューターを引きつけるからです。プロジェクトが企業のものなら、購入者はさらに後から、仕事でそれに依存しているユーザーの中から現れます。
| 観点 | あなたに求めるもの | 最初の一手 |
|---|---|---|
| ユーザー | 解決する問題のわかりやすい説明、動くクイックスタート、メンテナンスされている証拠。 | README の最初の画面を 1 人のユーザーと 1 つの問題に向けて書き直し、10〜20 秒のデモを添えます。 |
| コントリビューター | コントリビューションのガイドライン、ロードマップ、ラベル付きの入門用 Issue、親切に返信するメンテナー。 | CONTRIBUTING、短いロードマップ、説明の行き届いた Issue をいくつか追加し、初めての報告にはすべてお礼を伝えます。 |
| 購入者(何かを販売する場合) | 無料のプロジェクトを損なわない、お金を払う理由:ホスティング、サポート、チーム向け機能、コンプライアンス。 | 仕事で使っている人に、自分では運用したくないものは何かを尋ねます。 |
具体的な問題と利点を示す。ニッチを狙う。10〜20 秒のデモを共有する。README はユーザーの問題について書く。コントリビューターは自然なユーザーの広がりの後に続き、ガイドライン、ロードマップ、反応がよく親切なメンテナーを必要とする。ダウンロード数やスターではなく長期的な影響を測る。
GitHub Blog:Marketing for maintainers(2022 年 7 月)何かを宣伝する前のリポジトリのチェックリスト
どのチャネルも、人々を同じページに送ります。リポジトリが最初の画面で自らを説明できていなければ、宣伝は離脱する人を増やすだけです。まず各項目を確認してください。
- 説明と README の最初の行:誰のためのもので何をするのかを、実装の詳細なしにわかりやすい言葉で。
- 上部近くのデモ:最初の役立つ結果を見せる、10〜20 秒の GIF または短い動画。
- クイックスタート:コピー&ペーストできるインストール手順と、クリーンなマシンで動く 1 つのコマンドまたはコード片。ローンチ前にゼロからテストします。
- トピック:最大 20 個、小文字の英字・数字・ハイフンで、1 つにつき 50 文字まで。言語、フレームワーク、問題など、人々が検索する言葉を使います。
- ソーシャルプレビュー画像:最小 640×320、理想は 1280×640、1 MB 未満の PNG、JPG、GIF。X、Slack、Reddit で共有されたリンクが意図したとおりに見えるようにします。
- ライセンスファイル。企業が使ってよいかどうかを判断できるようにします。
- CONTRIBUTING、短いロードマップ、そして着手できるだけの背景が書かれた、新しく参加する人向けのラベル付きの Issue をいくつか。
- 活動の証拠:最近のリリース、回答済みの Issue、変更履歴。訪問者は、誰かが運営しているかを確かめます。
- 利用者:実際のユーザーや企業。名前を出すのは許可を得た場合だけです。
- ドキュメントやウェブサイトがあればそのリンクと、助けを得る方法。
小文字の英字、数字、ハイフン。50 文字以下。1 リポジトリにつき 20 個まで。トピックのページと検索は、人々がリポジトリを見つける助けになる。
GitHub Docs:Classifying your repository with topics最小 640×320 ピクセル、最適な表示には 1280×640。1 MB 未満の PNG、JPG、GIF。
GitHub Docs:Customizing your repository's social media previewプロジェクトの種類でローンチのチャネルを選ぶ
その問題を抱える人がすでに集まっている場所を 1 つ選び、プロジェクトがその問題を解決する様子を見せ、その場に残って質問に答えてください。2 つ目のチャネルは、最初のチャネルで人々が何を誤解するかがわかってからで構いません。
| 観点 | 最初のユーザーがいる場所 | 最初の一手 |
|---|---|---|
| ライブラリまたは SDK | そのフレームワークのコミュニティ、Issue トラッカーとディスカッション、そしてあなたのライブラリが答えになる Stack Overflow の質問。 | ライブラリが本当に役立つ既存の質問に答え、よくあるタスクを解決する短いサンプルを公開します。 |
| CLI または開発者ツール | Hacker News、開発者向けのサブレディット、ツールを紹介する X のアカウント。 | サインアップなしで試せる Show HN を投稿し、最初の数時間はコメント欄にいます。 |
| 有料製品のセルフホスト型の代替 | 有料製品の価格、制限、プライバシーに不満を持つ人々と、セルフホスティングのコミュニティ。 | 何を置き換えるのか、まだ何ができないのか、どう動かすのかをはっきり比較します。 |
| AI エージェントのツール、MCP サーバー、プラグイン | X と GitHub のビルダー、エージェントのフレームワークのコミュニティ、AI アシスタントのディレクトリ。 | エージェントがこれまでできなかったタスクを 1 つ見せるデモと、該当するディレクトリがあればそこへの掲載。 |
| オープンコアのスタートアップ | すでに仕事でプロジェクトを使っているチーム。 | 有料プランを発表する前に、企業のドメインからの Issue やインストールの背後にいる人々と話します。 |
逆効果になる宣伝
これらの手法は、プラットフォームのルールに違反するか、あなたを誤解させる数字を生み出します。ローンチの週の前に、計画をこの一覧と照らし合わせてください。
- スターを買う、ほかのメンテナーとスターを交換する、または自動でスターを付けるツールを使う。
- スター、フォロー、その他のエンゲージメントと引き換えに報酬、エアドロップ、プレゼントを提供する。
- 友人や同僚に、あなたの Show HN への投票やコメントを頼む。
- 人々が試せるものではなく、ランディングページ、ウェイティングリスト、サインアップフォームを Show HN として投稿する。
- ほかのプロジェクトの Issue で宣伝する、または多くのリポジトリに同じ宣伝を投稿する。
- GitHub のプロフィールをスクレイピングして、プロジェクトについての迷惑メールを送る。
- 自己宣伝のルールを読まずに、多くのサブレディットやグループに同じリンクを投稿する。
セクション 4 は、不正な活動、自動化されたスターなどのランキングの悪用、報酬で誘導したエンゲージメント、組織的な不正活動を禁止している。セクション 7 は、迷惑メールなどのスパムに GitHub の情報を使うことを禁止している。セクション 10 は、Issue での収益目的または過剰な大量コンテンツを禁止している。
GitHub Acceptable Use Policies人々が触って試せるもののためのもの。ブログ記事、サインアップページ、ニュースレター、リストは不可。ランディングページや資金調達も不可。友人に投票やコメントを頼まない。サインアップなしで簡単に試せるようにする。
Hacker News:Show HN guidelines30 日間のローンチ計画
- 1〜3 日目:ユーザー、問題、結果を示す 1 文を書きます。それをもとに、リポジトリの説明、README の最初の段落、デモを書き直します。
- 4〜7 日目:上のリポジトリのチェックリストを順に進めます。プロジェクトを見たことがない 2 人に、あなたが見ている前でクイックスタートを試してもらい、つまずいた箇所をすべて直します。
- 8〜14 日目:Issue、フォーラムのスレッド、投稿など、誰かがその問題を抱えている既存の会話を 20 件見つけます。プロジェクトが実際に役立つ場合にだけ返信し、自分が作ったものだと伝えます。
- 15〜21 日目:それらの会話が行われていたチャネルで、Show HN やデモの投稿など、公開のローンチを 1 回行います。コメント欄にとどまり、質問と反論をすべて書き留めます。
- 22〜30 日目:最も多かった反論を解消し、何が変わったかを書いたリリースを公開し、問題を報告してくれた人にお礼を伝え、この期間の記録を最初の期間の記録と比べます。
週ごとのローンチ記録をコピーする
GitHub は訪問者、クローン、上位の参照元、人気のコンテンツを直近 14 日間分だけ、しかもプッシュ権限を持つ人にだけ表示します。REST API が返すのも同じ 14 日間なので、毎週数字をコピーしないと失われます。パッケージのレジストリはより長い履歴を保持しています:npm のダウンロード API は、先週などの期間や 18 か月以内の日付範囲について答え、PyPI はダウンロード数を公開の BigQuery データセットに公開しています。
ダウンロード数は人ではなく、自動化されたものを含むインストールの回数です。記録にある人間のシグナル、つまり見知らぬ人からの Issue、初めてのコントリビューション、実際の仕事でプロジェクトを使っている人との会話と並べて、傾向として読んでください。
フルクローン、直近 14 日間の訪問者、参照元サイト、人気のコンテンツ。プッシュ権限を持つ人なら誰でも閲覧できる。
GitHub Docs:Viewing traffic to a repository日別または週別の閲覧数とクローン数、上位 10 の参照元とパス。直近 14 日間が対象。書き込み権限が必要。
GitHub REST API:Repository traffic直近 1 日、1 週間、1 か月、1 年、または日付範囲についてのポイントとレンジのエンドポイント。クエリは 18 か月分のデータに制限される。
npm registry:download countsダウンロードのイベントは、公開の BigQuery テーブル bigquery-public-data.pypi.file_downloads にストリーミングされる。
PyPI Docs:BigQuery datasets数字を合わせて読む
説明のための例であり、ベンチマークではありません:Show HN の前後 14 日間で、あるリポジトリに 2,400 人のユニーク訪問者と 180 人のユニーククローン者があったとすると、訪問者の 7.5% がクローンしたことになります(180 ÷ 2,400)。また、スターが 150 増え(訪問者 100 人あたり約 6)、チーム外の人から 12 件の Issue が届きます。最も多かった質問を中心に README を書き直した後の 14 日間は、訪問者は 2,000 人に減りますが、ユニーククローン者は 200 人、つまり 10%(200 ÷ 2,000)になります。訪れた人は減ったものの、試した人は増えました。スターの伸びは鈍くなっても、書き直しは効果があったのです。
スターはこうした文脈の中で読んでください。クローン、インストール、Issue に変化がないままスターが急増した場合、たいていは利用を伴わない注目を意味します。見知らぬ人からの Issue が増えている場合は、たとえバグ報告でも、たいていは実際に使われていることを意味します。
ユーザーから顧客へ
プロジェクトがスタートアップの一部なら、最初の顧客はたいていすでに Issue トラッカーの中にいます。仕事で使っている人を探し、自分では運用したくないものは何かを尋ね、料金ページを作る前に、ホスティング、サポート、チーム向け機能、コンプライアンスの支援など、有料のオファーを 1 つその人たちと試してください。
無料のプロジェクトは本当に役立つものに保ってください。クイックスタートをサインアップの後ろに移したり、ユーザーが頼りにしている機能を削除したりすると、彼らを連れてきた信頼が壊れます。また、Hacker News ではサインアップの壁があると Show HN の対象外になります。
Soloop の役割
Soloop はリポジトリにスターを付けたり、パッケージを公開したり、GitHub のプロジェクトを管理したりはしません。Soloop が手伝うのはその周辺のアウトリーチで、リポジトリから始めることができます。Soloop のマニュアルによると、人々がどこで問題について話しているかを調べて情報源を返すこと、OAuth で接続した後に X へ投稿すること、あなたが自分で公開する Reddit の投稿を準備すること、Gmail を通じてコールドメールを送ること、あなたの確認と支払いのために Google 検索広告を準備することができます。操作はデフォルトであなたの承認を待ちます。
範囲を絞った最初の依頼:私のオープンソース プロジェクト [リポジトリの URL] は、[ユーザー] が [結果を得る] のを助けます。[ユーザー] が [問題] について語っている最近の会話を情報源つきで 20 件探し、ローンチのチャネルを 1 つ提案し、HN のルールの範囲内で Show HN のタイトルと最初のコメントを下書きしてください。何も投稿・送信しないでください。
情報源、制限事項、更新
偽のスターに関する研究、GitHub の Acceptable Use Policies、トラフィック、トピック、ソーシャルプレビューのドキュメント、トラフィックの REST API、Show HN のガイドライン、npm と PyPI のダウンロードに関するドキュメント、GitHub のメンテナー向けマーケティングのパネル、Runa Capital の 2026 年第 3 四半期の ROSS Index を、2026 年 11 月 2 日に確認しました。GitHub は Trending や検索がリポジトリをどう順位付けするかを公開しておらず、ダウンロード数には自動化されたインストールが含まれます。層とチャネルの表、チェックリスト、計画、記録は編集部の指針であり、ファネルの例は説明のためのものです。ここに書かれていることは、スター、ユーザー、顧客のいずれも保証しません。
このガイドは 2027 年 2 月 2 日までに、または GitHub がスター、トラフィック、Trending のルールを変更した場合はそれより早く見直します。
Soloop のマニュアルは、情報源つきのリサーチ、OAuth による X への投稿、手動で公開する Reddit の準備、Gmail を通じたコールドメール、確認と支払いの後の Google 検索広告を説明している。承認がデフォルトで先に求められる。GitHub のリポジトリ、スター、パッケージのリリースは管理しない。
Soloop 製品マニュアル