search_documents
회계·공시 자료 전문검색
MyFSS MCP의 search_documents 도구는 금융감독원(FSS)·금융위원회(FSC) 회계·공시 자료를 전문검색합니다.
[Purpose]
- What 감독당국 checks — 심사·감리 지적사례·감독지침·모범사례 등 게시판 11종.
- Filters alone (no query) sweep a topic.
[Usage]
1. "전환사채 콜옵션 관련 감독원 자료" → query="전환사채 콜옵션"
2. "작년 감리 지적사례 전부" → board="sanction_case", date_from="2025-01-01", date_to="2025-12-31"
3. "내부회계관리제도 주제로 20건" → topics=["내부회계관리제도"], limit=20
[Response]
- { total, showing, offset, note, results:[{ntt_id, date, board, source, title, nature, topics,
depts, summary, url, snippet?}] }
- total = 전체 건수, showing = 이번 페이지 — paginate with offset.
- source: "fss"=금융감독원, "fsc"=금융위원회.
- snippet marks matches with [ … ]; only when a query matched.
[Rules]
- board is asymmetric: param = English key, response = 한글 라벨 — never feed it back.
- topics·depts are joined strings (", " / " / "), not arrays — split first.
- ≥3-char tokens → FTS (AND, rank); 1~2-char → LIKE. No query → 게시일 DESC, no snippet.
- Corpus = 2010 onward (absent = 미수록); quote body via get_document, not summary·snippet.
Parametersdeptboardlimitquerynatureoffsetsourcetopicsdate_todate_from
MyFSS MCP의 get_document 도구는 문서 전문을 반환합니다 — 첨부 HWP를 마크다운으로 변환한 본문.
[Purpose]
- To read and quote a found document — summary·snippet are never quoting grounds.
[Usage]
1. "그 자료 본문 보여줘" → ntt_id=12345
2. "길어서 잘렸는데 이어서" → ntt_id=12345, offset_chars=60000
3. "앞부분만 짧게" → ntt_id=12345, max_chars=8000
[Response]
- { ntt_id, date, board, source, title, nature, topics, depts, summary, url,
attachments:[{file_name, ext, parsed}], body_total_chars, offset_chars, truncated, body }
- truncated=true means offset_chars+max_chars < body_total_chars — raise offset_chars to continue.
- Unknown id returns { error: "ntt_id {n} 없음" }.
- body = "(본문 없음)" when nothing was parsed and no HTML 본문 exists.
[Rules]
- body = parsed attachments (parsed=true) joined under "## 첨부: {file_name}" heads;
with no attachment body it falls back to the detail-page HTML body (mostly FSC).
- attachments with parsed=false are NOT in body — disclose the gap, never hide it.
- Continue with offset_chars; raising max_chars grows the whole response.
Parametersntt_idrequiredmax_charsoffset_chars
MyFSS MCP의 list_recent 도구는 최신 문서 목록을 게시일 내림차순으로 반환합니다.
[Purpose]
- Query-less skim of "what came out lately", optionally narrowed by 게시판.
[Usage]
1. "최근 자료 뭐 있어" → (인자 없음 — limit=20)
2. "감리 지적사례 최신 10건" → board="sanction_case", limit=10
3. "금융위 보도자료 최신" → board="fsc_press"
[Response]
- { results:[{ntt_id, date, board, source, title, nature, topics, depts, summary, url}] }
- No total/offset — this tool has no pagination, and no snippet (there is no query).
[Rules]
- board takes the English key while the response returns the 한글 라벨 — same asymmetry as
search_documents; never feed the response board back as a parameter.
- Sorted by 게시일(date) — retroactively registered old documents never surface as new.
- For period/topic narrowing or larger volumes use search_documents.
Parametersboardlimit
MyFSS MCP의 list_tags 도구는 검색 필터에 넣을 수 있는 어휘를 반환합니다 — 주제 태그·문서 성격·게시판·주요 담당부서.
[Purpose]
- Which values actually exist for search_documents' topics·nature·board·dept.
Invented values return 0 rows, not an error — check here before a futile search.
[Usage]
1. "어떤 주제로 검색할 수 있어?" → (인자 없음)
[Response]
- { topics:[{name, n}], natures:[{name, n}], boards:[{key, label, n}], depts_top25:[{name, n}] }
- n = 그 값이 붙은 문서 수.
- boards[].key is what the board parameter takes; boards[].label is what responses show.
[Rules]
- topics is exact-match — no partial/synonym matching; pass a name from here verbatim.
- dept is the opposite, partial match — a fragment like "회계감리" works.
- depts_top25 is only the top 25 — a 부서 missing from the list still exists.
Takes no parameters.