@severzemlya/campusmate-cli

A CLI tool for searching the Kyushu University (九州大学) Campusmate-J syllabus system. Returns structured JSON, designed for use as a Claude Code skill.

Features

• Lecture search — search by lecture name, instructor, faculty, semester
• Instructor search — find all lectures by an instructor (two-step lookup)
• Full-text search — search across all syllabus content
• Detail retrieval — get complete syllabus for a specific lecture code

Requirements

• Node.js 20+
• Network access to ku-portal.kyushu-u.ac.jp

Usage

No installation required — just use npx:

npx @severzemlya/campusmate-cli search-lecture --name "線形代数"
npx @severzemlya/campusmate-cli search-lecture --name "物理" --faculty "050" --limit 20
npx @severzemlya/campusmate-cli search-instructor --name "田中"
npx @severzemlya/campusmate-cli search-fulltext --keyword "機械学習"
npx @severzemlya/campusmate-cli detail --code 26533320

Or install globally:

npm install -g @severzemlya/campusmate-cli
campusmate-cli search-lecture --name "線形代数"

Common Options

| Option | Description | Default | |--------|-------------|---------| | --year <year> | Academic year | Current year | | --limit <n> | Max results to return | 10 |

Output Format

Search Result

{
  "total": 38,
  "count": 10,
  "results": [
    {
      "code": "26533320",
      "name": "線形代数学・同演習A",
      "semester": "前期",
      "schedule": "火3",
      "instructor": "山田 太郎"
    }
  ]
}

Syllabus Detail

{
  "code": "26533320",
  "name": "線形代数学・同演習A",
  "instructor": "山田 太郎",
  "credits": 3,
  "year": 2026,
  "semester": "前期",
  "schedule": "火3",
  "purpose": "...",
  "syllabus": [
    { "week": 1, "theme": "ガイダンス", "content": "..." }
  ]
}

See src/types.ts for full type definitions.

Claude Code Skill Setup

This tool includes a Claude Code skill definition at skills/campusmate-skill/SKILL.md.

Copy the skill directory to your Claude Code skills location:

cp -r skills/campusmate-skill ~/.claude/skills/

After registering, Claude Code will automatically use this skill when you ask about Kyushu University courses, syllabi, or instructors. For example:

> 九大の線形代数の講義を検索して
> What courses does Professor Tanaka teach at Kyushu University?
> 講義コード 26533320 のシラバスを見せて

Development

npm install
npm run build       # Compile TypeScript
npm test            # Run tests (51 tests)
npm run test:watch  # Watch mode

Tech Stack

• TypeScript (ESM, Node16 module resolution)
• Commander — CLI framework
• Axios — HTTP client
• Cheerio — HTML parsing
• Vitest — Test framework

License

MIT