ScienceON 연결/토큰 상태 점검. 실패 시 원인 힌트와 현재 공인 IP 를 반환.

ScienceON 문헌 검색.

query: 단일 검색어 / queries: 여러 검색어(개별검색 후 CN 합집합) — 둘 중 하나 target: ARTI(논문)·REPORT(보고서)·ATT(동향)·RESEARCHER·ORGAN field: BI(전체)·TI(제목)·AB(초록)·AU(저자)·KW(키워드). 와일드카드 * 사용 가능(예: 느린*). year_from~year_to: 발행연도(범위는 PY 틸드). rows: 반환 건수(최대 100). contains: 원본 전체필드에 이 문자열(들) 포함 결과만(대소문자 무시 후처리 필터). lang: 허용 언어(예: ["한국어"]) — 국내(국문) 한정 등.

반환값의 total 은 ScienceON 이 보고한 전체 건수(축별 합, 합집합 상한)이고, truncated=true 면 rows 상한에 잘린 것이다. 이때 warning 이 함께 붙는다. ⚠️ 절단된 결과를 완전한 코퍼스로 오인하면 후속 분석이 무효가 된다.

제어번호(CN)로 상세 서지·초록 조회.

검색 결과를 대량 수집해 파일로 저장(xlsx/csv/json/sqlite). 저장 경로 반환.

queries=[...] 여러 용어 개별검색 후 CN 합집합. contains=[...] 후처리 필터, lang=["한국어"] 국내한정. out_dir 미지정 시 사용자 홈의 scienceon-output/ 에 저장(MCP는 임의 cwd에서 기동).

⚠️ max_records(기본 500)는 조용히 자르지 않는다 — 상한에 걸리면 meta.truncated=true 와 warning 이 붙는다. meta.union_upper_bound 는 실행한 검색축들의 total 합(합집합 상한)이므로, 절단됐다면 max_records 를 그 위로 올려 재수집해야 코퍼스가 완결된다. 수집량이 max_records 와 정확히 일치하면 거의 항상 절단이다.

여러 검색 그룹을 한 코퍼스로 합쳐 수집(CN 중복제거). config 파일 없이 대화형으로.

그룹마다 다른 필드·후처리 필터를 걸 수 있어, 단일 검색어로는 못 만드는 코퍼스를 만든다. 각 group = {"field": "BI", "terms": [...], "contains": [...], "lang": [...], "max": N} field : BI(전체)·TI(제목)·AB(초록)·AU(저자)·KW(키워드) terms : 그 필드로 개별 검색할 용어들(와일드카드 * 가능) contains: 원본 전체필드 substring 후처리 필터(노이즈 제거, 대소문자 무시) lang : 허용 언어(예: ["한국어"]) — 국문 논문 한정 등 max : 그 그룹만의 상한(미지정 시 max_records)

예) 변별력 있는 단어는 BI 로 그대로, 색인 안 되는 토큰은 TI 와일드카드 + contains 로 정밀화: [{"field":"BI","terms":["경계선지능","경계선 지능"]}, {"field":"TI","terms":["느린*"],"contains":["느린학습자","느린 학습자"]}]

save=true(기본) 면 파일로 저장하고 경로를 반환한다. save=false 면 레코드를 직접 반환하되 응답 폭주를 막기 위해 앞 100건만 싣는다(meta 는 전량 기준).

⚠️ meta.truncated=true 면 상한에 걸려 잘린 것이다 — meta.union_upper_bound(그룹별 total 합) 위로 max_records 를 올려 재수집해야 코퍼스가 완결된다.