{
  "utcp_version": "1.0.1",
  "manual_version": "1.0.0+30ccbbeaa8e42588",
  "info": {
    "title": "FHL Bible Tools",
    "description": "信望愛站聖經工具（資料來源：信望愛站 https://bible.fhl.net，說明頁最後修改 Sat, 24 Oct 2026 13:05:45 GMT）。\n書卷可用 USFM（JHN、1MA）、和合本書名（約、約翰福音）、英文（John）或 FHL 編號。搜尋結果很多時，用回傳的 next_cursor 取下一頁。\n託管模式只提供公有領域、著作權已過期或開放授權（GFDL、CC）的內容；其他內容會回報無法提供。每筆結果附 source 授權說明，引用時請一併註明。著作權宣告：https://www.fhl.net/main/fhl/fhl8.html"
  },
  "tools": [
    {
      "name": "read_passage",
      "description": "讀取一段經文（正典、次經或使徒教父，依書卷自動選擇）。例：約翰福音 3:16 → {book:\"JHN\", chapter:3, verses:\"16\"}。不給 verses 則讀整章。跨章或多段請用 lookup_reference（如 \"約3:35-4:2\"、\"約3-4\"）。",
      "inputs": {
        "type": "object",
        "properties": {
          "book": {
            "type": [
              "string",
              "integer"
            ],
            "description": "書卷：USFM（JHN、1MA）、和合本書名（約、約翰福音）、英文（John）或 FHL 編號（43；次經 101-115；使徒教父 201-217）"
          },
          "chapter": {
            "type": "integer",
            "minimum": 1,
            "description": "章"
          },
          "verses": {
            "type": "string",
            "description": "節：16、1-5、1,5,6、1-2,5；省略＝整章"
          },
          "version": {
            "type": "string",
            "default": "unv",
            "description": "譯本代碼或名稱（unv＝和合本、kjv、rcuv＝和合本2010…，見 list_versions）。僅正典適用"
          },
          "strong": {
            "type": "boolean",
            "default": false,
            "description": "附 Strong 編號（需譯本支援）"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "book",
          "chapter"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/read_passage",
        "content_type": "application/json"
      }
    },
    {
      "name": "lookup_reference",
      "description": "用經文出處字串查經文，可一次多段、可跨章。例：\"約3:16;羅5:8\"、\"約3:35-4:2\"、\"約3-4\"（整章）、\"John 3:16\"。僅正典。",
      "inputs": {
        "type": "object",
        "properties": {
          "reference": {
            "type": "string",
            "description": "出處：約3:16、約 3:16-18;羅5:8、John 3:16（中英文書名皆可，多段以 ; 分隔；跨章 約3:35-4:2；整章範圍 約3-4）"
          },
          "version": {
            "type": "string",
            "default": "unv",
            "description": "譯本代碼或名稱（見 list_versions）"
          },
          "strong": {
            "type": "boolean",
            "default": false,
            "description": "附 Strong 編號"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "reference"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/lookup_reference",
        "content_type": "application/json"
      }
    },
    {
      "name": "search_text",
      "description": "用關鍵字（或 Strong 編號）搜尋經文，可跨正典、次經、使徒教父，可限定書卷或新舊約。回傳總筆數與分頁；要下一頁時只傳 cursor。",
      "inputs": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "關鍵字；mode=greek/hebrew 時為 Strong 編號（如 25）"
          },
          "corpus": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "bible",
                "apocrypha",
                "fathers"
              ]
            },
            "default": [
              "bible"
            ],
            "description": "搜尋範圍：bible＝正典、apocrypha＝次經、fathers＝使徒教父；有給 books 時自動推定"
          },
          "books": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "限定書卷（可不連續）：USFM 代碼或中英文書名，如 [\"MAT\",\"MRK\",\"LUK\",\"JHN\"]、[\"約\",\"羅\"]"
          },
          "testament": {
            "type": "string",
            "enum": [
              "all",
              "OT",
              "NT"
            ],
            "default": "all",
            "description": "all＝不限、OT＝舊約、NT＝新約（僅正典）"
          },
          "mode": {
            "type": "string",
            "enum": [
              "text",
              "greek",
              "hebrew"
            ],
            "default": "text",
            "description": "text＝經文關鍵字；greek／hebrew＝原文 Strong 編號（僅正典）"
          },
          "version": {
            "type": "string",
            "default": "unv",
            "description": "正典譯本（見 list_versions）"
          },
          "page_size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20,
            "description": "每頁筆數"
          },
          "cursor": {
            "type": "string",
            "description": "上一頁回傳的 next_cursor；給了就只看 cursor"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/search_text",
        "content_type": "application/json"
      }
    },
    {
      "name": "word_analysis",
      "description": "一節經文的原文逐字分析（希臘文／希伯來文）：原文、Strong 編號、詞性、字形、原型、中文解釋。可再用 strongs_lookup 查字典。",
      "inputs": {
        "type": "object",
        "properties": {
          "book": {
            "type": [
              "string",
              "integer"
            ],
            "description": "書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66"
          },
          "chapter": {
            "type": "integer",
            "minimum": 1,
            "description": "章"
          },
          "verse": {
            "type": "integer",
            "minimum": 1,
            "description": "節"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "book",
          "chapter",
          "verse"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/word_analysis",
        "content_type": "application/json"
      }
    },
    {
      "name": "strongs_lookup",
      "description": "依 Strong 編號查原文字典（中英文釋義、同源字）。G＝希臘文（新約）、H＝希伯來文（舊約）。例：G25（ἀγαπάω）、H430（אֱלֹהִים）。",
      "inputs": {
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "Strong 編號，須帶 G／H 前綴：G25、H430"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "number"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/strongs_lookup",
        "content_type": "application/json"
      }
    },
    {
      "name": "commentary",
      "description": "讀某節經文的註釋。預設為信望愛站註釋（GFDL）；可用 list_commentaries 取得的 id 指定一本或多本。",
      "inputs": {
        "type": "object",
        "properties": {
          "book": {
            "type": [
              "string",
              "integer"
            ],
            "description": "書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66"
          },
          "chapter": {
            "type": "integer",
            "minimum": 1,
            "description": "章"
          },
          "verse": {
            "type": "integer",
            "minimum": 1,
            "description": "節"
          },
          "commentary_ids": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "註釋書 id（見 list_commentaries）；省略＝信望愛站註釋（3）"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "book",
          "chapter",
          "verse"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/commentary",
        "content_type": "application/json"
      }
    },
    {
      "name": "list_commentaries",
      "description": "列出註釋書（id、名稱、是否可用），供 commentary／search_commentary 使用。",
      "inputs": {
        "type": "object",
        "properties": {
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/list_commentaries",
        "content_type": "application/json"
      }
    },
    {
      "name": "search_commentary",
      "description": "在註釋書中搜尋關鍵字，回傳命中的段落與經文範圍（預設信望愛站註釋；超過 500 筆時請用更精確的關鍵字）。",
      "inputs": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "要在註釋中搜尋的關鍵字"
          },
          "commentary_ids": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "註釋書 id（見 list_commentaries）；省略＝託管版為信望愛站註釋、本機版為全部"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "keyword"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/search_commentary",
        "content_type": "application/json"
      }
    },
    {
      "name": "topics",
      "description": "主題查經（Torrey、Nave's，英文與中譯）。用關鍵字找主題，或用 topic_id 讀某主題。",
      "inputs": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "主題關鍵字（英文書籍請用英文關鍵字，如 love）"
          },
          "topic_id": {
            "type": "integer",
            "description": "主題編號（優先於 keyword）"
          },
          "source": {
            "type": "string",
            "enum": [
              "all",
              "torrey_en",
              "naves_en",
              "torrey_zh",
              "naves_zh"
            ],
            "default": "all",
            "description": "主題書：all＝全部（託管版為兩本英文）、torrey_en、naves_en、torrey_zh、naves_zh（中譯僅本機版）"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/topics",
        "content_type": "application/json"
      }
    },
    {
      "name": "places",
      "description": "某章（或某節）提到的地點：名稱（英、現代、和合本…）、座標、原文編號、是否有照片。說明文字僅本機版提供。",
      "inputs": {
        "type": "object",
        "properties": {
          "book": {
            "type": [
              "string",
              "integer"
            ],
            "description": "書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66"
          },
          "chapter": {
            "type": "integer",
            "minimum": 1,
            "description": "章"
          },
          "verse": {
            "type": "integer",
            "minimum": 1,
            "description": "省略＝整章"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "required": [
          "book",
          "chapter"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/places",
        "content_type": "application/json"
      }
    },
    {
      "name": "audio",
      "description": "某章的有聲聖經 mp3／ogg 連結（多種語言與方言）。",
      "inputs": {
        "type": "object",
        "properties": {
          "book": {
            "type": [
              "string",
              "integer"
            ],
            "description": "書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66"
          },
          "chapter": {
            "type": "integer",
            "minimum": 1,
            "description": "章"
          },
          "recording": {
            "type": "string",
            "enum": [
              "和合本",
              "台語",
              "客家話",
              "廣東話",
              "現代中文譯本",
              "台語新約",
              "紅皮聖經",
              "希伯來文",
              "福州話",
              "希臘文",
              "spring台語",
              "spring和合本",
              "NetBible中文版",
              "全民台語聖經",
              "鄒語",
              "台語南部腔",
              "現代台語譯本",
              "現代客語譯本",
              "達悟語"
            ],
            "default": "和合本",
            "description": "錄音版本"
          }
        },
        "required": [
          "book",
          "chapter"
        ],
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/audio",
        "content_type": "application/json"
      }
    },
    {
      "name": "rare_books",
      "description": "珍本聖經：不給參數＝列出全部書目；給 id＝該書書目資料；給 book+chapter（可加 verse、id）＝找出有該經文的珍本頁面與影像連結。影像只提供授權允許自由使用者（GNU FDL、澳洲國家圖書館 NLA）。",
      "inputs": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "珍本書籍編號"
          },
          "book": {
            "type": [
              "string",
              "integer"
            ],
            "description": "書卷（正典）：USFM（JHN）、和合本書名（約、約翰福音）、英文（John）或編號 1-66"
          },
          "chapter": {
            "type": "integer",
            "minimum": 1,
            "description": "章"
          },
          "verse": {
            "type": "integer",
            "minimum": 1,
            "description": "節"
          },
          "simplified": {
            "type": "boolean",
            "default": false,
            "description": "true＝簡體輸出（輸入也要用簡體）"
          }
        },
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/rare_books",
        "content_type": "application/json"
      }
    },
    {
      "name": "list_versions",
      "description": "可用的聖經譯本（代碼、名稱、是否有 Strong 編號、是否只有新約／舊約）。",
      "inputs": {
        "type": "object",
        "properties": {
          "search": {
            "type": "string",
            "description": "篩選名稱或代碼"
          }
        },
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/list_versions",
        "content_type": "application/json"
      }
    },
    {
      "name": "list_books",
      "description": "書卷代碼對照：USFM、和合本書名、英文、FHL 編號（正典、次經、使徒教父）。",
      "inputs": {
        "type": "object",
        "properties": {
          "corpus": {
            "type": "string",
            "enum": [
              "bible",
              "apocrypha",
              "fathers"
            ],
            "description": "只列某一部分：bible＝正典、apocrypha＝次經、fathers＝使徒教父；省略＝全部"
          }
        },
        "additionalProperties": false
      },
      "outputs": {
        "type": "object"
      },
      "tags": [
        "bible",
        "fhl"
      ],
      "tool_call_template": {
        "name": "fhl_bible_tools",
        "call_template_type": "http",
        "http_method": "GET",
        "url": "https://fhl-tools.ai4.tw/tool/list_books",
        "content_type": "application/json"
      }
    }
  ]
}