トゥーンエル

トゥーンエルの縦読み漫画の作品と話を、言葉とジャンルで探す。題名・あらすじ・登場人物のほか、作品が扱う仕事・暮らし・制度・お金・手続きの言葉（例：無申告加算税、施工管理、置き配、生活保護）からも探せる。用語の解説（get_glossary）や、その言葉が出てくる話を探す入口にもなる。query が空なら全作品の一覧（id・名前・ジャンル・URL・話の数だけ）を返す。当たった話のうち第2話以降には spoiler の印（up_to_episode を渡すと、それより後の話は返さない）。

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "探す言葉（例：加算税、施工管理、置き配、配車）。空白で区切ると、全部を含む物を返す"
    },
    "genre": {
      "type": "string",
      "description": "ジャンルの id か名前（例：isekai／異世界転生、mystery／ミステリー）"
    },
    "up_to_episode": {
      "type": "integer",
      "minimum": 1,
      "description": "利用者が読んだ話の番号（ネタバレを避ける）。これより後の話のあらすじ・用語を省く。分からなければ省く（全部を返し、第2話以降に spoiler の印）"
    }
  }
}

作品の公開中の話の一覧（番号・題名・公開日・要約・URL）と作品の説明・用語集を返す。up_to_episode（利用者が読んだ話）を渡すと、それより後の話の要約と用語を省く。渡さない時は全部を返し、第2話以降の項目に spoiler の印。

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "作品の id（search_works の結果の id。例：kengai）"
    },
    "up_to_episode": {
      "type": "integer",
      "minimum": 1,
      "description": "利用者が読んだ話の番号（ネタバレを避ける）。これより後の話のあらすじ・用語を省く。分からなければ省く（全部を返し、第2話以降に spoiler の印）"
    }
  },
  "required": [
    "series_id"
  ]
}

話の本文を Markdown で返す（話者付きの台詞・ナレーション・作中の画面・絵の説明・あらすじ・登場人物・この話で分かること）。中身はその話まで。up_to_episode（利用者が読んだ話）が number より前なら、ネタバレの断りを頭に付ける。

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "作品の id"
    },
    "number": {
      "type": "integer",
      "minimum": 1,
      "description": "話の番号（1から）"
    },
    "up_to_episode": {
      "type": "integer",
      "minimum": 1,
      "description": "利用者が読んだ話の番号（ネタバレを避ける）。これより後の話のあらすじ・用語を省く。分からなければ省く（全部を返し、第2話以降に spoiler の印）"
    }
  },
  "required": [
    "series_id",
    "number"
  ]
}

話のコンテキストセット（作品の設定・登場人物・あらすじ・この話で分かること〈仕事・制度の問いの短い答えと条件〉・用語・出典・URL の短いまとめ）を返す。話の内容を踏まえて答える時や、続きを相談する時の前提に使う。中身は第1話からその話まで（後の話は入らない）。up_to_episode が number より前なら、ネタバレの断りを頭に付ける。

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "作品の id"
    },
    "number": {
      "type": "integer",
      "minimum": 1,
      "description": "話の番号（1から）"
    },
    "up_to_episode": {
      "type": "integer",
      "minimum": 1,
      "description": "利用者が読んだ話の番号（ネタバレを避ける）。これより後の話のあらすじ・用語を省く。分からなければ省く（全部を返し、第2話以降に spoiler の印）"
    }
  },
  "required": [
    "series_id",
    "number"
  ]
}

公開日の新しい順に、話の一覧を返す。

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "件数（既定 10）"
    }
  }
}

作品の用語集を返す。仕事・制度・お金・手続きの言葉（例：無申告加算税、施工管理技士、置き配の盗難の補償）の短い解説と、作中の世界の決まりか現実の事実かの区別、出典（法令・省庁の資料などの URL。ある物だけ）、出てくる話の番号。漫画の場面でどう出てくるかは get_episode で読める。どの作品の用語かは search_works で探せる。up_to_episode（利用者が読んだ話）を渡すと、それより後の話で初めて出る用語を省く。渡さない時は全部を返し、第2話以降の用語に spoiler の印。

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "作品の id"
    },
    "up_to_episode": {
      "type": "integer",
      "minimum": 1,
      "description": "利用者が読んだ話の番号（ネタバレを避ける）。これより後の話のあらすじ・用語を省く。分からなければ省く（全部を返し、第2話以降に spoiler の印）"
    }
  },
  "required": [
    "series_id"
  ]
}