# Syosetu Scraper by Keyword

Syosetu Scraper by Keyword

- Template page: [https://www.octoparse.com/template/syosetu](https://www.octoparse.com/template/syosetu)
- Categories: Others
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from general web pages.

## Output

The current workflow extracts 19 fields, including `Nコード`, `あらすじ`, `エピソード数`, `キーワード`, `ジャンル`, `タイトル`, `ブックマーク`, `レビュー数_件`, `作品情報リンク`, `作者`, `文字数`, `最終更新日`, `状況`, `総合ポイント_pt`, `評価ポイント`, `評価人数`, `詳細リンク`, `読了時間`, `週別ユニークユーザー`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Keyword and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keyword

Optional. キーワード入力 Constraints: maxLength=100.

## How to Use

## Syosetu Scraper by Keyword

Collects search result data from [Syosetu](https://ncode.syosetu.com/) by keyword.

### Input
- **Keyword** (optional): Enter search terms.

### Output
Returns structured data from search result pages. Available fields include タイトル, 詳細リンク, 作者, 作品情報リンク, あらすじ, Nコード, エピソード数, 状況, ジャンル, キーワード, 最終更新日, 文字数, 読了時間, 週別ユニークユーザー, レビュー数_件, 総合ポイント_pt, ブックマーク, 評価人数, 評価ポイント. Some fields may be empty if the source does not provide them.

### Pricing
No per-line charge. Octoparse plan or resource limits may apply.

### Limitations
- Collects fields only from search results; does not retrieve detail-page data.
- Fields such as ブックマーク, 評価人数, and 評価ポイント can be empty.

### Tips
- Run with a few inputs first, then scale.
- Use the most specific valid keyword to reduce irrelevant results.
- Use a stable identifier (e.g., タイトル, Nコード) as a deduplication key.

### How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the **Keyword** input (optional).
3. Choose a local or cloud run.
4. Review the output rows and export or process the data.

### Scheduling & API
You can schedule recurring runs and export data via Octoparse or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates). Scheduling and API access may require a paid Octoparse plan.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Airbnb Scraper (by Keyword)](https://www.octoparse.com/template/airbnb-scraper-by-keyword)
- [Naver Map Scraper(by Keyword)](https://www.octoparse.com/template/naver-map-scraper)
- [Shein Scraper (Product Listing by Keyword)](https://www.octoparse.com/template/shein-scraper-product-listing-by-keyword)
- [eBay Spain Product Listing Scraper (by Keyword)](https://www.octoparse.com/template/ebay-listados-scraper)
- [Google Shopping Price Monitor (by Keyword)](https://www.octoparse.com/template/google-shopping-price-monitor-by-keyword)

## Input Schema

```json
{
  "title": "Syosetu Scraper by Keyword input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "title": "Keyword",
      "description": "キーワード入力",
      "type": "string",
      "maxLength": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": []
}
```

## Input JSON Example

Example 1

```json
{
  "keyword": "異世界"
}
```

Example 2

```json
{
  "keyword": "異世界"
}
```

Example 3

```json
{
  "keyword": "異世界"
}
```

Example 4

```json
{
  "keyword": "異世界"
}
```

Example 5

```json
{
  "keyword": "異世界"
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Nコード": {
      "type": "string",
      "description": ""
    },
    "あらすじ": {
      "type": "string",
      "description": ""
    },
    "エピソード数": {
      "type": "string",
      "description": ""
    },
    "キーワード": {
      "type": "string",
      "description": ""
    },
    "ジャンル": {
      "type": "string",
      "description": ""
    },
    "タイトル": {
      "type": "string",
      "description": ""
    },
    "ブックマーク": {
      "type": "string",
      "description": ""
    },
    "レビュー数_件": {
      "type": "string",
      "description": ""
    },
    "作品情報リンク": {
      "type": "string",
      "description": ""
    },
    "作者": {
      "type": "string",
      "description": ""
    },
    "文字数": {
      "type": "string",
      "description": ""
    },
    "最終更新日": {
      "type": "string",
      "description": ""
    },
    "状況": {
      "type": "string",
      "description": ""
    },
    "総合ポイント_pt": {
      "type": "string",
      "description": ""
    },
    "評価ポイント": {
      "type": "string",
      "description": ""
    },
    "評価人数": {
      "type": "string",
      "description": ""
    },
    "詳細リンク": {
      "type": "string",
      "description": ""
    },
    "読了時間": {
      "type": "string",
      "description": ""
    },
    "週別ユニークユーザー": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Syosetu Scraper by Keyword output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Nコード": "N9016MV",
  "あらすじ": "黒澤 零は17歳の高校生。\nトラックに引かれ死亡した彼が最後に願ったのは――\n\n『英雄』の様な、人間になること。\n次の人生こそ、立派な人間になると決意した彼だったが、彼が異世界転生した先はと言うと、\n\n『大罪人』ルイ・レルゼンであった。\n\nルイを『英雄』と言う少女と『大罪人』と言う世界からの声に、彼は\"ルイ・レルゼン\"という男が何者なのか、分からなくなる。\n\n\"ルイ・レルゼン\"とは、『英雄』か、『大罪人』か――",
  "エピソード数": "15",
  "キーワード": " 残酷な描写あり ＥＳＮ大賞１１ ギャグ シリアス ダーク 男主人公 魔王 勇者 中世 魔法 冒険 日常 ダンジョン",
  "ジャンル": "ハイファンタジー〔ファンタジー〕",
  "タイトル": "大罪の英雄",
  "ブックマーク": " 0",
  "レビュー数_件": "0",
  "作品情報リンク": "https://ncode.syosetu.com/novelview/infotop/ncode/n9016mv/",
  "作者": "虚無人",
  "文字数": "53,703",
  "最終更新日": "2026/10/14 18:50",
  "状況": "連載中",
  "総合ポイント_pt": "0",
  "評価ポイント": "0",
  "評価人数": "0",
  "詳細リンク": "https://ncode.syosetu.com/n9016mv/",
  "読了時間": "約108分",
  "週別ユニークユーザー": "101"
}
```

Example 2

```json
{
  "Nコード": "N9669IC",
  "あらすじ": "九法宮学園の入学式を終え、講堂を出た極楽天福良は見知らぬ森にいた。 そこは、魔物が人を食らい、漂う瘴気が身体を蝕む異常な世界。 けれど、福良は慌てない。彼女には、護身術として身につけた壇ノ浦流弓術と、生まれつきの桁外れな幸運があった。 拾った石を武器に、使える道具やスキルを活用し、危険な世界をマイペースに進んでいく。 豪運のお嬢様による、殺伐とした異世界サバイバル。『即死チート』外伝。",
  "エピソード数": "75",
  "キーワード": " R15 残酷な描写あり 異世界転移 女主人公 冒険 即死チート外伝 お嬢様 サバイバル 豪運",
  "ジャンル": "アクション〔文芸〕",
  "タイトル": "無理ゲーみたいな異世界ですけど、壇ノ浦流弓術でどうにかなりますか？　～即死チート外伝～",
  "ブックマーク": " 3,392",
  "レビュー数_件": "0",
  "作品情報リンク": "https://ncode.syosetu.com/novelview/infotop/ncode/n9669ic/",
  "作者": "藤孝剛志",
  "文字数": "249,590",
  "最終更新日": "2026/10/09 10:37",
  "状況": "連載中",
  "総合ポイント_pt": "14,374",
  "評価ポイント": "7,590",
  "評価人数": "845",
  "詳細リンク": "https://ncode.syosetu.com/n9669ic/",
  "読了時間": "約500分",
  "週別ユニークユーザー": "2,258"
}
```

Example 3

```json
{
  "Nコード": "N1516MU",
  "あらすじ": "王都は落ち、父王も兄姉も処刑された。\n\nたった13歳で王位を継いだ第3王女カタリナの手元に残ったのは、丘の離宮、逃げ込んだ領民、わずかな兵、そして王国を滅ぼしに来た帝国軍5万人だった。\n\nだが彼女には、前世――航空機メーカーの研究者として生きた記憶がある。\n\n使える魔法は、同じ体積の物質を入れ替えるだけの「転移魔法」。火球も雷撃も出せない。ならば密度、質量、距離、温度差、そして化学を使えばいい。\n\n5万人の帝国軍が消えたあと、待っていたのは勝利の宴ではなかった。5万人分の後始末、680人の捕虜、9割以上を失った行政組織、遺族補償、占領軍についてきた商人たちの国外退去。カタリナは魔法より先に、女王として国を立て直していく。\n\nしかし帝国には、5万人がどこへ消えたのか分からない。\n\n「海軍へ寝返ったのか？」\n\n混乱した帝国は、今度こそ確かめるため8万人を送り込む。\n\nそして二度目の大軍が低湿地で壊滅した夜、神は13歳の女王へ告げる。\n\n「君は十三万人の魂を持っている。もう魔王になれるよ」\n\n科学で戦争を生き残り、行政で国を再建し、ついには“魔王”になる少女の国家再生譚。\n",
  "エピソード数": "1",
  "キーワード": " R15 異世界転生 女主人公 魔王 近世 職業もの 内政 魔法 ミリタリー オリジナル戦記",
  "ジャンル": "ハイファンタジー〔ファンタジー〕",
  "タイトル": "魔国と魔王の誕生　13歳の第3王女は魔王になることを選びました。",
  "ブックマーク": " 0",
  "レビュー数_件": "0",
  "作品情報リンク": "https://ncode.syosetu.com/novelview/infotop/ncode/n1516mu/",
  "作者": "アントノフ",
  "文字数": "2,403",
  "最終更新日": "2026/09/22 17:25",
  "状況": "連載中",
  "総合ポイント_pt": "0",
  "評価ポイント": "0",
  "評価人数": "0",
  "詳細リンク": "https://ncode.syosetu.com/n1516mu/",
  "読了時間": "約5分",
  "週別ユニークユーザー": "100未満"
}
```

Example 4

```json
{
  "Nコード": "N6593DK",
  "あらすじ": "　かつて天界に壊滅的被害をもたらした蛇神ヴリトラ。色々あって天界の神々と和解した後、彼は自身の能力を活用できる餓鬼道の治安維持局長官に就任した。 　真面目に仕事をしていたらある時転機が訪れる。地上界へ行き世界の秩序を乱すものを倒せ、という仕事が舞い込んできたのだ。 　上からの命令なので特に何を思うでも無く了承するが、この仕事にはある条件があったのだ。 　人間に転生しなければならないという条件が……。",
  "エピソード数": "3,461",
  "キーワード": " R15 残酷な描写あり 異世界転生 人外 西洋 学園 中世 魔法",
  "ジャンル": "ハイファンタジー〔ファンタジー〕",
  "タイトル": "崩天蛇神の秩序維持",
  "ブックマーク": " 498",
  "レビュー数_件": "0",
  "作品情報リンク": "https://ncode.syosetu.com/novelview/infotop/ncode/n6593dk/",
  "作者": "てるてるぼうず",
  "文字数": "4,437,821",
  "最終更新日": "2026/09/16 00:45",
  "状況": "連載中",
  "総合ポイント_pt": "1,531",
  "評価ポイント": "535",
  "評価人数": "76",
  "詳細リンク": "https://ncode.syosetu.com/n6593dk/",
  "読了時間": "約8,876分",
  "週別ユニークユーザー": "706"
}
```

Example 5

```json
{
  "Nコード": "N3926ML",
  "あらすじ": "これは、居場所を知らなかった少女が、世界で一番大切な”家族”を見つけるまでの物語。\n\n世界最高峰の技術を持つ魔法使いによって、誤って異世界へ召喚されてしまった少女・葵。\n\n言葉も文化も異なる世界で暮らすことになった彼女は、少しずつ新たな生活に馴染み、大切な仲間たちとの出会いを経て立派な魔法使いへと成長していく。\n\nしかし、この世界には数々の秘密が眠っていた。\n\n世界樹に隠された真実、各国が抱える思惑、そして葵を誤召喚した魔法使いが隠し続ける秘密。\n\n葵は無事、元の世界へ帰ることができるのか。\n\nーーー\n\nバトル要素よりもストーリー及びキャラクター重視の小説です。生成AIは誤字脱字チェックの為にのみ活用しています。また、当方初投稿のため、厳しいお言葉は極力御遠慮ください。\n\n月曜日〜金曜日の週5回投稿予定です。ストックは尽きました。自転車操業中です。",
  "エピソード数": "132",
  "キーワード": " 異世界転移 アイリスIF9大賞 女主人公 魔法 日常 集英社小説大賞７ 仲間 絆",
  "ジャンル": "ハイファンタジー〔ファンタジー〕",
  "タイトル": "箱庭の大賢者",
  "ブックマーク": " 0",
  "レビュー数_件": "0",
  "作品情報リンク": "https://ncode.syosetu.com/novelview/infotop/ncode/n3926ml/",
  "作者": "はなあふ",
  "文字数": "610,437",
  "最終更新日": "2026/09/08 20:03",
  "状況": "連載中",
  "総合ポイント_pt": "22",
  "評価ポイント": "22",
  "評価人数": "3",
  "詳細リンク": "https://ncode.syosetu.com/n3926ml/",
  "読了時間": "約1,221分",
  "週別ユニークユーザー": "204"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "syosetu",
  "taskName": "Syosetu Scraper by Keyword",
  "parameters": "{\"keyword\":\"異世界\"}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"keyword\":\"異世界\"}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "syosetu",
        "taskName": "Syosetu Scraper by Keyword",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "syosetu",
  "taskName": "Syosetu Scraper by Keyword",
  "parameters": "{\"keyword\":\"異世界\"}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `syosetu`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/syosetu.json)
- [Manifest](https://www.octoparse.com/templates/syosetu-manifest.json)