Semantic + keyword search over Taiwan.md knowledge base

tw_search_taiwan_md

TW-specificMIT

**關鍵字 / Keywords**: 台灣百科知識庫 wiki Taiwan.md article 歷史文化人物地理 encyclopedia semantic search

Taiwan.md 開源台灣知識庫 · 語意 + 關鍵字檢索 (v1.46 聯名 corpus).

Taiwan.md (frank890417/taiwan-md) 是社群共筆 AI-native 台灣百科, 涵蓋
14 大分類, ~5,100 篇文章 / ~117k 個 chunks. Twinkle Hub 每週自動 sync
GitHub main 分支.

參數:
    query: 白話 query, 例「228 事件」「珍珠奶茶起源」「台積電製程」
          「日治鐵道史」「新竹科學園區發展」
    category: 分類過濾, 常見值 (case-sensitive):
              History / Culture / Geography / Food / Economy /
              Technology / Art / Nature / Music / People / Society /
              Lifestyle / Politics / About
    lang: 語言篩選, 預設 zh-tw. 其他: en, ja, ko
    heading_contains: chunk 標題必須含此子字串 (硬性 filter)
    limit: top-K (1..50, 預設 10)
    dedup_by_article: True 時同一 article 最多 1 chunk (預設 True)

回傳:
    {n_corpus, n_returned, query, attribution, license_notice,
     hits: [{article_id, chunk_id, chunk_index, chunk_text, heading,
             category, lang, similarity, title, summary,
             source_url, updated_at}, ...]}

用 article_id 接 `tw_get_taiwan_md_article(article_id)` 拿完整文章.

⚠ **License**: Taiwan.md 為 CC BY-SA 4.0. 使用本工具回傳的內容時必須:
   1. 標註來源: attribution 欄位提供
   2. 若你重製 / 改編, 衍生物須採相同 CC BY-SA 4.0 授權

Input schema

{
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lang"
    },
    "heading_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Heading Contains"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    },
    "dedup_by_article": {
      "default": true,
      "title": "Dedup By Article",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "title": "tw_search_taiwan_mdArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see tw_search_taiwan_md. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 tw_search_taiwan_md 處理 "…"。

# It will call:
tw_search_taiwan_md(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs