Semantic + keyword teacher-recruitment question search

tw_search_teacher_recruit_questions

TW-specificMIT

**關鍵字 / Keywords**: 教甄題目縣市甄試選擇題 teacher recruit question 教甄考古題

以自然語言 + (可選) 關鍵字過濾, 檢索**教甄題目**級別.

Corpus: 教師甄選 (各縣市政府), Phase 1 ~5 縣市/聯盟 選擇題逐題抽取
+ Qwen3-Embedding-4B 向量化. 各縣市各科目命題不一, 題型多元.

**與 tw_search_teacher_exam_questions 區隔**:
  - 教檢 (teacher_exam) = 教育部全國共通試題 (取得教師證)
  - 教甄 (teacher_recruit) = 縣市政策性試題 (取得正式教職)

參數:
    query: 自然語言, 例「國小數學分數教學」「特殊教育鑑定」
    stem_contains: 題幹必含此子字串 (硬性 keyword filter)
    county / stage / subject_contains: 同 tw_search_teacher_recruit
    year_from / year_to: 西元年範圍
    limit: top-K (1..100)

回傳 schema:
    {n_corpus, n_returned, query,
     hits: [{paper_id, county, exam_year (民國), exam_year_西元,
             exam_name, stage, subject_name, question_no,
             question_type, stem, options{A,B,C,D}, answer,
             similarity}, ...]}

典型用法:
    tw_search_teacher_recruit_questions("音樂理論基本概念")
    tw_search_teacher_recruit_questions("數學分數", county="taipei", stage="es")
    tw_search_teacher_recruit_questions("特殊教育", subject_contains="特殊")

Input schema

{
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "stem_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Stem Contains"
    },
    "county": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "County"
    },
    "stage": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Stage"
    },
    "subject_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Subject Contains"
    },
    "year_from": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Year From"
    },
    "year_to": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Year To"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "tw_search_teacher_recruit_questionsArguments",
  "type": "object"
}

How to call

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

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

# It will call:
tw_search_teacher_recruit_questions(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