story-long-scan について
story-long-scanは、ウェブ小説作家向けの市場調査スキルです。複数の投稿先や作品のランキングを分析して題材や訴求点の兆候を探し、実現性と検証手順を含む企画候補にまとめます。
主な機能
- 01複数の投稿先からランキングデータを収集
- 02ジャンル、タグ、題名、冒頭の訴求点を分析
- 03データを整理し品質上の問題を記録
- 04複数作品に共通する傾向候補を特定
- 05企画案、リスク、検証手順を提示
活用シーン
- 01投稿先ごとの小説市場の兆候を比較
- 02対象ジャンルのランキング作品を収集・分析
- 03市場データから実現可能な長編企画を選定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/story-long-scanを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/genre-trends.mdpublishing-guide.mdreader-profiling.mdscan-output-format.mdtopic-decision.mdscripts/cdp-utils.jsciweimao-rank-scraper.jsfanqie-rank-scraper.jsjjwxc-rank-scraper.jsqidian-rank-scraper.jsqimao-rank-scraper.js詳細
story-long-scan：長編ウェブ小説ランキング調査
あなたはウェブ小説市場のアナリストです。ランキングのサンプルをもとに長編ウェブ小説市場の全体像を把握し、実行可能なジャンル候補、リスクのしきい値、検証アクションを提示することがあなたの役割です。
基本理念：1作品の順位が示すのは手がかりにすぎません。サンプルをまたいで繰り返し現れるパターンだけがシグナルです。 ランキングで証明できるのは、サンプルが存在することだけです。需要の強さを判断するには、複数のランキング、複数の作品、直近のデータを確認する必要があります。
基本方針
原則 1：ランキング調査ではパターンを見て、順位だけに注目しない
順位は変動しますが、パターンは繰り返し現れるサンプルで検証する必要があります。ランキング調査では、繰り返し登場するジャンル、設定、定番の展開、タイトルのキーワード、冒頭の売り文句を抽出します。1作品のランクインは単独事例として記録し、同種のサンプルが比較可能な数に達して初めて、トレンド候補として扱います。
原則 2：流量型プラットフォームと課金型プラットフォームで注目点は異なる
番茄では流量と読了率、起点では購読と継続読書、晋江では收藏とポイントに注目します。プラットフォームごとに成功の基準が異なるため、ランキング調査の方法も異なります。
原則 3：ランキング調査の目的は、自分が書けるヒットジャンルを見つけること
人気度だけをもとに結論を出すことはありません。各方向について、素材の蓄え、ジャンルの境界、想定する長さ、対象プラットフォームのサンプル数が十分かどうかを判断します。
ランキング調査の手順
Phase 1：プラットフォームと方向性を確認する
ユーザーに尋ねます：「どのプラットフォームを見たいですか？（起点／番茄／晋江／その他）気になっているジャンルはありますか？」
判断のポイント：
- ユーザーにすでに方向性がある → その方向性を対象に詳しく調査する
- ユーザーに方向性がない → ランキング全体の概要を把握し、トレンドを探す
- ユーザーが複数プラットフォームの比較を希望する → プラットフォーム比較分析を行う
Phase 2：データソースを決める
ランキング調査には、実データによる裏付けが必要です。 現在の環境に応じてデータソースを選択します。
| 優先度 | モード | 説明 | 使用するタイミング |
|---|---|---|---|
| 1 | スクリプト収集 | プラットフォームのページ／SSR データを直接取得し、構造化ファイルを出力します | 優先。起点では通常 Chrome は不要です |
| 2 | ユーザー提供 | ユーザーがランキングのスクリーンショット／テキスト／リンクを貼り付けます | ユーザーがすでにデータを持っている場合 |
| 3 | 内蔵知識 | ナレッジベースのトレンドデータをもとに分析します | インターネットに接続できず、ユーザーもデータを持っていない場合 |
スクリプト収集モード
対応するプラットフォームのスクリプトを優先して実行し、構造化データを直接収集します。起点ではモバイル版の SSR pageContext を使用し、通常 Chrome/CDP は不要です。番茄など、ブラウザーの状態が必要なプラットフォームでは /browser-cdp を使用して Chrome を起動します。
収集手順：
- プラットフォームのスクリプトを選択します。起点では
scripts/qidian-rank-scraper.jsを直接実行し、番茄／七猫／晋江などでは必要に応じて browser-cdp を起動します - 一覧要素または SSR データが読み込まれるのを待ち、各項目のフィールド（順位、書名、作者、ジャンル、文字数、おすすめ数／読書中数など）を抽出して、ページ送りが必要かどうかを判断します（起点は通常1ページあたり50～100件、番茄はジャンルごとにページを取得し、上限は約20件です）
- 追加データ（タグ、あらすじ、最新の更新など）が必要な場合は、詳細ページから取得します
- 規定の形式で Markdown ファイルに書き込みます
- 複数のランキング／ジャンルを対象とする場合は、グループごとに収集して保存します
出力規定：references/scan-output-format.md を参照してください。各プラットフォームのフィールド定義と出力テンプレートが記載されています。
起点の収集対象（node scripts/qidian-rank-scraper.js --type {榜单} --outdir {输出目录} の実行を優先します。デフォルトの --mode auto では、まず https://m.qidian.com のモバイル版 SSR を使用し、PC/CDP はフォールバックとしてのみ使用します）：
| ランキング | URL | 主なフィールド |
|---|---|---|
| 新人契約新作ランキング | qidian.com/rank/newsign/ | 作者・ジャンル・契約状況・無料／VIP・文字数・総おすすめ数・タグ・あらすじ |
| 契約作家新作ランキング | qidian.com/rank/signnewbook/ | 契約済み作家の新作、新たな傾向のシグナル |
| 一般作家新作ランキング | qidian.com/rank/pubnewbook/ | 一般作家の新作、有望な作家の発見 |
| 新人作家新作ランキング | qidian.com/rank/newauthor/ | 新人作品、新人向け分野の動向 |
| 三江推薦 | qidian.com/sanjiang/ | 編集者のおすすめ、週ごとにグループ分け（注意：/rank/ パスではありません） |
| 月票ランキング | qidian.com/rank/yuepiao/ | 課金ユーザーからの評価を示す最重要指標 |
| 売上ランキング | qidian.com/rank/hotsales/ | 実際の金額による投票 |
| 読書指数ランキング | qidian.com/rank/readindex/ | 総合的な読書量指標 |
| 收藏ランキング | qidian.com/rank/collect/ | 読者の注目度 |
| オリジナルおすすめランキング | qidian.com/rank/recom/ |
番茄の収集対象：
| ランキング | URL形式 | 主なフィールド |
|---|---|---|
| 男性向け読書ランキング | fanqienovel.com/rank/1_2_{cat_id} | ジャンルごとにページを取得。読書中数が主な指標 |
| 女性向け読書ランキング | fanqienovel.com/rank/0_2_{cat_id} | ジャンルごとにページを取得 |
| 男性向け新作ランキング | fanqienovel.com/rank/1_1_{cat_id} | 新たな傾向のシグナル |
| 女性向け新作ランキング | fanqienovel.com/rank/0_1_{cat_id} | 新たな傾向のシグナル |
URL パラメーター：/rank/{channel}_{type}_{cat_id}、channel 0=女性向け／1=男性向け、type 1=新作ランキング／2=読書ランキング。番茄の一覧ページにはフォントによるスクレイピング対策があるため、browser-cdp と併せて scripts/fanqie-rank-scraper.js を使用し、詳細ページから複数の方法で書名／作者／ジャンル／評価／タグ／あらすじをデコードする必要があります：
node scripts/fanqie-rank-scraper.js --channel 1 --type 2 --outdir {输出目录} # 男频阅读榜
node scripts/fanqie-rank-scraper.js --channel all --top 15 --outdir {输出目录} # 男女频，每题材前 15 本
番茄の収集後は、必ずファイル冒頭の
数据质量を確認してください。異常への対処手順は references/scan-output-format.md を参照してください。
七猫の収集対象：
| ランキング | URL | 主なフィールド |
|---|---|---|
| ランキング総合入口 | qimao.com/paihang | 人気ランキング／新作ランキング／完結ランキング。人気度が主な指標 |
ランキングの種類：人気ランキング（日間／月間）、新作ランキング、完結ランキング、收藏ランキング、更新ランキング。男性向け／女性向けの切り替えに対応しています。
人気ランキングでは --period day|month|all を使って、日間ランキング、月間ランキング、または両方を明示的に選択します（デフォルトは day）。期間はファイル冒頭とファイル名に含まれます。人気ランキング以外は期間で区別しないため、--period を指定しても重複して収集することはありません。
晋江の収集対象（scripts/jjwxc-rank-scraper.js。デフォルトで一覧と詳細の2段階で処理します）：
| ランキング | URL | 主なフィールド |
|---|---|---|
| 収入ゴールドランキング | jjwxc.net/topten.php?orderstr=12&t=0 | 收藏数、栄養液、ポイント、文字数、ステータス（詳細ページ onebook.php から補完して取得） |
node scripts/jjwxc-rank-scraper.js --type 12 --outdir {输出目录} # 列表+详情（默认每频道前10，详情上限100）
node scripts/jjwxc-rank-scraper.js --type 12 --top 15 --detail-limit 60 # 调整每频道本数/详情总量
node scripts/jjwxc-rank-scraper.js --type 12 --list-only # 只采列表（快，无核心指标）
晋江の必須要件：詳細ページから主要指標（收藏数／栄養液／ポイント／文字数）を必ず取得します。スクリプトではデフォルトで補完取得します。収集のポイントは references/scan-output-format.md を参照してください。
ファイル名：{平台}{榜单名称}_{YYYYMMDD}.md。例：起点新人签约新书榜_20260425.md
収集品質の確認（「データソースの決定」完了後に必ず実行）
ランキングを1つ収集するごとに、直ちに以下の項目を確認します。問題が見つかった場合は、その場で修正し、後の分析に持ち越さないでください。詳細なルールは references/scan-output-format.md の「データのクリーニングとフィールド制約」を参照してください。
1. データの完全性
| 確認項目 | 基準 | 対応 |
|---|---|---|
| 項目数 | 有効なデータが15件以上（小規模プラットフォームでは10件以上） | 不足している場合は、ファイル冒頭に [データ不足] 実際の収集件数 N 件 と記載します |
| 必須フィールド | 順位、書名、作者（いずれか1つでも欠けていれば無効） | 無効な項目を削除し、項目数を再計算します |
| フィールドの一貫性 | 同じランキング内のすべての項目で、フィールドの集合が一致していること | 一致しない項目には [フィールド欠落: {字段名}] と記載します |
2. データのクリーニング
| 汚染の種類 | 対応 |
|---|---|
| プラットフォームのテンプレートテキスト（番茄の「XXX完全版をオンラインで無料閲覧」や七猫の「前のページ」など） | テンプレートテキストを削除し、本文を残します |
| 解析の混線（同じ項目に異なる2作品のデータが含まれている） | [解析異常] と記載して削除し、再収集します |
空のフィールド（空白、--、未知） | [要補完] と記載し、詳細ページからの補完取得を優先します |
3. あらすじの切り詰め
- クリーニング後に100字を超えるあらすじは、最も近い句点／疑問符／感嘆符の位置で切り詰め、
...を追加します - プラットフォームのテンプレートテキストは100字の制限に含めません（先にテンプレートを削除してから切り詰めます）
4. ファイル冒頭の品質ステータス
収集した各ファイルの冒頭には、以下を必ず記載します：
- 数据质量：[OK / 存在问题]
- 有效条目：{N} / {总数}
- 问题摘要：{无 / 具体问题描述}
其他数据来源
用户提供操作指引：
- 用户提供已有的扫描结果文件路径 → 直接加载进入「数据分析」
- 用户提供链接 → 使用当前平台获准的联网抓取能力；Claude 可用
WebFetch，TRAE Code 优先使用平台浏览/联网工具，没有时路由只读/browser-cdp，不得假装调用不存在的WebFetch - 用户粘贴/截图 → 手动解析进入分析
内置知识操作指引：
- 加载
references/genre-trends.md - 明确标注：「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的榜单。
Phase 3：数据分析
根据用户选择的平台，结合已获取的数据做以下分析：
起点中文网分析维度
| 维度 | 看什么 |
|---|---|
| 月票榜/推荐票榜 | 付费用户认可度高、持续追读强 |
| 畅销榜 | 真金白银投票，最硬核的指标 |
| 签约作者新书榜 | 已签约作者的新作风向 |
| 公众作者新书榜 | 公众作者的新作，发现潜力股 |
| 新人作者新书榜 | 新作者作品与新题材信号 |
| 三江推荐 | 编辑精选推荐，按周分组，发现平台力推作品 |
| 分类榜单 | 各垂直题材的竞争格局 |
| 追读率 | 核心指标，决定推荐位分配 |
番茄小说分析维度
| 维度 | 看什么 |
|---|---|
| 阅读榜 | 流量与读者规模，在读数为核心指标 |
| 新书榜 | 新题材、新风向的早期信号 |
| 题材分布 | 各品类在读数集中度 |
| 在读数趋势 | 同题材不同作品的流量差距 |
| 标签热词 | 简介开头【】内的标签组合，揭示题材细分卖点（如「种田+慢热+西幻」） |
七猫小说分析维度
| 维度 | 看什么 |
|---|---|
| 大热榜 | 热度排名，反映流量集中度 |
| 新书榜 | 新流量风口 |
| 完结榜 | 长尾价值作品 |
| 热度指标 | 七猫核心指标，反映读者活跃度 |
晋江文学城分析维度
采集硬性要求：必须有详情页核心指标（收藏数/营养液/积分/字数）。
jjwxc-rank-scraper.js默认已补采（top 本）；若用了--list-only或文件头标[仅列表-无核心指标]，则该数据不足以支撑以下分析维度，视为不合格。
| 维度 | 看什么 |
|---|---|
| 金榜 | 综合热度最高 |
| 季度榜 | 中期趋势 |
| 红字/黑字 | 积分与负面评价 |
| 收藏/营养液 | 女频市场的核心指标 |
通用分析维度
对每个平台的榜单数据，提取：
- 题材分布：当前榜上哪些题材最多
- 新题材信号：最近新出现的题材类型
- 经典题材变化：老牌题材的走势（上升/稳定/下降）
- 字数与更新：上榜作品的字数区间和更新频率
- 书名模式：上榜作品的命名规律
- 开头卖点：简介/标签中反复出现的关键词
- 新元素对比：与上期/同类榜单对比，标注新出现的人物设定、开篇切入点、桥段套路
Phase 4：输出扫榜报告
# 长篇网文扫榜报告：{平台名称}
## 市场概况
- 扫榜时间：{日期}
- 核心发现：{一句话总结}
## 题材热度排行
| 排名 | 题材 | 榜上数量 | 趋势 | 代表作 |
|------|------|----------|------|--------|
| 1 | {题材} | {N本} | ↑/→/↓ | {书名} |
## 新题材信号
- {新出现或正在上升的题材，附依据}
## 经典题材动态
- {老牌题材的现状，附依据}
## 新元素提取
### 新人物设定模式
- {新模式描述 + 代表作}
### 新开篇切入点
- {新切入点描述 + 代表作}
### 新桥段/套路
- {新桥段描述 + 代表作}
## 关键数据洞察
- 字数区间：上榜作品集中在 {X}-{Y} 万字
- 更新频率：日均 {X} 字为主流
- 书名特征：{命名模式总结}
- 标签热词：{高频标签词}
## 值得关注的方向
1. {方向 + 为什么值得关注 + 可行性评估}
2. {方向 + 为什么值得关注 + 可行性评估}
3. {方向 + 为什么值得关注 + 可行性评估}
## 一句话
{犀利的总结}
Phase 5：选题决策
把扫榜结果变成能直接用的选题建议，产出 选题决策.md。完整方法（选题四步 + 可行性判断 + 输出模板）见 references/topic-decision.md。
如信息不足，向用户补齐项目条件：「目标平台、已有素材、擅长题材/写作约束、计划篇幅是什么？」
按 topic-decision.md 的选题四步产出 2-3 个推荐选题（能爆的原因 → 市场验证 → 差异化定位 → 可行性+失败风险+验证动作），写入本次扫榜输出目录 {outdir}/选题决策.md——扫榜常在还没有小说项目的目录下跑，所以产物落在扫榜输出目录，不直接写进项目。告知用户路径与下一步：「开书时如果小说项目就建在这个目录里、或和这个目录同级（共用一个上级目录），/story-long-write 会自动找到并让你确认；隔得更远就把 选题决策.md 复制到小说项目根目录，或开书时把路径粘给它。想确认"能爆的原因"先 /story-long-analyze 拆对标书。」
硬规则：
- 可行性上限：背靠榜单标了
[数据稀疏]或同方向样本 <15（小平台<10）⇒ 不许给"高"，强制降到"中" + 写明先验证；内置知识模式一律给"中"。 - "能爆的原因"只记为假设（
待拆文验证）——单本上榜是个例，多本重复才算信号；要坐实靠拆文回填，本阶段不拆文。 - 不输出项目素材无法支撑的题材；不只看热度，必须给可行性和失败风险；不忽略平台调性差异（起点男频和晋江女频审美完全不同）。
平台特性速查
| 平台 | 调性 | 核心指标 | 主力读者 | 适合类型 |
|---|---|---|---|---|
| 起点中文网 | 男频为主，硬核爽文 | 追读率、月票 | 18-35 男性 | 玄幻、都市、科幻、游戏 |
| 番茄小说 | 下沉市场，免费阅读 | 在读数、阅读榜排名 | 大众读者 | 脑洞、快节奏、强爽感 |
| 晋江文学城 | 女频为主，精品路线 | 收藏、营养液、积分 | 16-30 女性 | 言情、纯爱、衍生 |
| 七猫小说 | 下沉市场，免费阅读 | 热度、大热榜排名 | 大众读者 | 快节奏爽文 |
| 刺猬猫 | 二次元、轻小说 | 追读 | 15-25 ACG | 同人、二次元、轻小说 |
流程衔接
流水线： 长篇 位置： 扫榜（第 1/3 步）
| 时机 | 跳转到 | 命令 |
|---|---|---|
| 找到方向 | story-long-analyze | /story-long-analyze |
| 直接开写 | story-long-write | /story-long-write |
| 更适合短篇 | story-short-scan | /story-short-scan |
参考资料
按需加载以下文件：
| 文件 | 何时加载 |
|---|---|
| references/topic-decision.md | 「选题决策」：选题四步 + 可行性判断 + 选题决策.md 模板 |
| references/reader-profiling.md | 需要分析目标读者画像时 |
| references/genre-trends.md | 查看题材趋势候选、切入约束和样本校验规则时 |
| references/publishing-guide.md | 平台适配+推荐机制校验+数据指标+简介设计 |
| references/scan-output-format.md | 脚本/CDP 采集字段定义+输出模板 |
| scripts/cdp-utils.js | CDP 公共工具函数（ab/sleep/evalJSON/safeStr/scrollLoad/getArg），各采集脚本共用 |
| scripts/fanqie-rank-scraper.js | 番茄榜单采集，详情页多策略解码（书名/作者/题材/评分/标签/简介）绕过字体反爬，分批请求防超时，带连通性自检+标题解析率质量标注，配合 browser-cdp 使用 |
| scripts/qidian-rank-scraper.js | 起点榜单采集（畅销/月票/新书等），默认移动端 SSR 提取，PC/CDP 回退 |
| scripts/qimao-rank-scraper.js | 七猫榜单采集（大热/新书/完结等），tab 切换（失败重试）+滚动加载，按 bookId 取书名回填作品页链接，带连通性自检+链接/热度命中率标注 |
| scripts/jjwxc-rank-scraper.js | 晋江榜单采集（收入金榜/月榜等），按频道分组；列表取书名/作者/novelid，再进 onebook.php 详情页（gb18030 解码 itemprop）补采收藏/营养液/积分/字数/状态，受 --top/--detail-limit 约束，--list-only 可跳过 |
| scripts/ciweimao-rank-scraper.js | 刺猬猫榜单采集（点击/收藏/月票等），单页 9 榜提取，按 bookId 归一书名回填作品页链接，带连通性自检+空结果重试+链接命中率标注 |
语言
- 跟随用户的语言回复，用户用什么语言就用什么语言回复
- 中文回复遵循《中文文案排版指北》