keris-academic-search

Search Korean theses, academic articles, and research reports via the KERIS RISS Open API.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill keris-academic-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: keris-academic-search
Source: https://github.com/NomaDamas/k-skill/tree/main/keris-academic-search
Command: npx skills add https://github.com/NomaDamas/k-skill --skill keris-academic-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Finding Korean academic literature requires manually navigating the RISS portal and repeating searches across theses, domestic and international articles, books, and research reports. This Skill queries the official KERIS RISS search Open API directly and returns structured metadata in one step.

Core Features & Use Cases

  • Unified academic search: Query by keyword, title, author, subject, or publisher across theses, domestic/international articles, books, research reports, and journals, with combined resource types merged round-robin.
  • Structured metadata output: Returns title, authors, publisher, year, RISS detail link, and full-text availability/free-access flags as JSON or readable text, with pagination up to 100 results per page.
  • Use Case: Ask for papers on "인공지능 교육" and receive a summarized list of matching theses and articles with authors, publication years, and links, without opening the RISS website.

Quick Start

Ask the agent to search RISS for Korean academic papers about a topic such as "한국어 교육" and summarize the top results with links.

Frequently Asked Questions about keris-academic-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Korean theses and academic papers programmatically?

Use the RISS search Open API through this skill's search command with keyword, title, author, subject, or publisher filters. Results include title, authors, publisher, year, RISS detail link, and full-text availability flags in JSON or text format.

How do I get a RISS API key for KERIS academic search?

Register at riss.kr with an institutional affiliation, then apply at the RISS API center for a search API key. Keys are issued free to non-profit institutions and universities after KERIS review, then set via the KSKILL_RISS_API_KEY environment variable.

Can I use a data.go.kr API key for RISS search?

No, data.go.kr keys are completely separate from RISS search API keys and are not accepted. The data.go.kr dataset 15071949 covers static catalog files, not the article and thesis search API, so it cannot be used as a fallback.

Does RISS search download full-text papers automatically?

No, the skill is read-only metadata search and never downloads full text, bypasses institutional login, or automates copy or loan requests. It only reports the API-provided full-text availability flag and provides the RISS detail link.

Why does combined resource-type search only support page 1?

Combined types like ALL or A merge results from multiple upstream RISS endpoints round-robin, so accurate later pages are not possible. For page 2 and beyond, search a single resource type such as T, D, or B.