개발자 API

Conference Partner API 및 MCP 서버

Conference Partner의 전체 데이터에 프로그램으로 읽기 전용 접근이 가능합니다: 학술 학회 5,799건과 저널 1,213종. CFP와 투고 마감일, 개최 일자와 장소, 나란히 제공되는 CCF / ICORE / QUALIS 등급, 과거 게재율, 회차 이력, 저널 임팩트 팩터, ISSN, 특별호를 포함합니다. 동일한 데이터에 두 가지 인터페이스가 있습니다: REST API와 AI 에이전트용 네이티브 MCP 서버입니다.

지금 바로 사용해 보기

다음 세 명령은 자격 증명도 계정도 없이 그대로 실행됩니다:

# AI 분야에서 향후 3개월 이내에 마감되는 학회
# (키워드 불필요 — 모든 검색 파라미터는 선택 사항이며 자유롭게 조합할 수 있습니다)
curl "https://www.myhuiban.com/api/conferences?field=ai&submission_date_start=2026-08-01&submission_date_end=2026-11-01"

# 현재 논문을 모집 중인 학회
curl "https://www.myhuiban.com/api/conferences/rankings/cfp?per_page=5"

# 사이트 전체 통계(총계, 월별 마감, 등급 분포, 연구 분야, 국가 분포)
curl "https://www.myhuiban.com/api/statistics"

모든 응답에 X-Quota-Limit와 X-Quota-Remaining이 포함되어 그날 남은 횟수를 확인할 수 있습니다. CORS가 열려 있어 브라우저 JavaScript에서도 호출할 수 있습니다.

REST 엔드포인트

엔드포인트 반환 내용 인증
GET /api/conferences 검색. 모든 파라미터는 선택 사항이며 자유롭게 조합할 수 있습니다: query, ccf_rank, core_rank, qualis_rank, field (21개 연구 영역), submission_date_start, submission_date_end, conference_date_start, conference_date_end, updated_since (증분 동기화). 불필요
GET /api/conferences/rankings/{ranking} 선별된 목록: cfp, past_cfp, ccf, core, qualis, most_viewed, most_tracked, most_attended, most_competitive, upcoming, past, trending. 불필요
GET /api/journals 검색. 모든 파라미터는 선택 사항입니다: query, ccf_rank, issn, field, updated_since. 불필요
GET /api/journals/rankings/{ranking} 선별된 목록: cfp, ccf, highest_if, most_viewed, most_tracked, all. 불필요
GET /api/statistics 총계, 향후 월별 마감, 진행 중인 CFP의 등급별 분포, 그리고 국가·연구 분야·임팩트 팩터·출판사 분포. 불필요
GET /api/conferences/{id} 전체 상세: CFP 전문, 게재율 추이, 회차 이력, 평점, 댓글, 관련 학회·저널. 계정 필요
GET /api/journals/{id} 전체 상세: CFP 전문, 특별호, 평점, 댓글, 관련 저널·학회. 계정 필요
GET /api/researchers/{id} 연구자의 공개 프로필: 소속 기관, 자동 생성된 연구 관심사 요약, CV, 관심·참가 학회 및 저널. 연락처는 절대 포함하지 않으며, ID로만 조회할 수 있고 연구자 검색이나 열거는 제공하지 않습니다. 계정 필요
POST /api/login 계정 자격 증명을 JWT로 교환합니다. 불필요

모든 목록은 page와 per_page로 페이지를 나눌 수 있습니다(페이지당 최대 100건). 기계 판독 가능한 전체 명세는 OpenAPI 3 스키마를 참고하세요.

MCP 서버(AI 에이전트용)

네이티브 Model Context Protocol 서버가 POST https://www.myhuiban.com/mcp에서 Streamable HTTP로 동작하며, 공식 MCP 레지스트리에 com.myhuiban.www/conference-partner(으)로 등록되어 있습니다. 아무 MCP 클라이언트에나 추가할 수 있습니다. 예:

claude mcp add --transport http huiban https://www.myhuiban.com/mcp

여덟 가지 도구: search_conferences, search_journals, list_conferences, list_journals, get_conference, get_journal, get_researcher, get_statistics.검색 도구는 REST 검색 엔드포인트와 완전히 동일한 선택적 필터(21개 영역의 연구 분야, 각종 등급, 투고·개최 일자 범위)를 받습니다.

다음 도구는 자격 증명 없이 사용할 수 있습니다: search_conferences, search_journals, list_conferences, list_journals, get_statistics. 세 가지 상세 도구(get_conference, get_journal, get_researcher)에는 자격 증명이 필요합니다 — 아래를 참고하세요.

이 서버는 MCP prompts(프롬프트)도 제공합니다. 클라이언트가 한 번의 클릭으로 시작할 수 있는 출발점으로 보여주므로, 도구 이름 목록을 앞에 두고 무엇을 물어볼지 고민할 필요가 없습니다: upcoming_deadlines, where_to_submit, venue_snapshot, open_special_issues. 각각은 어떤 도구를 호출해야 하는지 명시한 요청으로 펼쳐지며, 연구 분야나 며칠 앞까지 볼지 같은 선택 인자를 받습니다.

모든 MCP 도구에는 대응하는 REST 엔드포인트가 있습니다(예: get_researcher ↔ GET /api/researchers/{id}). 두 경로는 동일한 쿼리 계층을 사용하고 완전히 같은 페이로드를 반환하므로, 파싱 로직을 바꾸지 않고 전송 방식을 전환할 수 있습니다.

상세 엔드포인트용 자격 증명 발급받기

  1. myhuiban.com/registration에서 무료 계정을 등록하고 이메일 인증을 완료합니다.
  2. myhuiban.com/account/api-keys에서 API 키를 생성합니다. 키는 한 번만 표시되며, 저희는 해시 값만 저장합니다.
  3. 모든 요청에 함께 보냅니다: Authorization: Bearer <credential> 
    curl -H "Authorization: Bearer hb_..." \
  https://www.myhuiban.com/api/conferences/1

MCP 클라이언트 연결도 같은 방식입니다. Claude, ChatGPT, Cursor, VS Code 모두 원격 MCP 서버 URL(https://www.myhuiban.com/mcp)과 고정 요청 헤더 하나만으로 추가할 수 있습니다. API 키는 바로 이 형태에 들어맞으며 토큰 갱신 과정도 필요 없습니다.

API 키는 만료되지 않으며 같은 페이지에서 하나씩 폐기할 수 있습니다. 키마다 사용량이 따로 집계되므로 클라이언트별로 다른 키를 발급할 수 있습니다. 실행 중에 자격 증명을 교환하고 싶다면 POST /api/login이 약 6개월간 유효한 JWT를 반환합니다. 키와 같은 용도로 쓸 수 있지만 개별 폐기는 불가능합니다.

한 계정의 모든 자격 증명은 같은 일일 한도(하루 200회 요청)를 공유합니다(REST API와 MCP 서버 합산).

셀프서비스로는 열려 있지 않지만 요청하면 제공할 수 있는 것이 세 가지 있습니다. 더 높은 한도, 각 학회 / 학술지 자체의 공식 사이트 URL(일반 응답은 detail_page만 돌려줍니다), 그리고 데이터셋 일괄 내보내기입니다. 만들고 계신 것을 [email protected]로 보내주시면 무엇이 가능한지 알려드리겠습니다 —— 공개된 가격표는 없습니다. 지금까지 요청이 모두 서로 달랐기 때문입니다.

로컬 사본 동기화 유지

먼저 updated_since 없이 전체를 한 번 받은 뒤, 확인한 가장 최근 updated_at 값을 updated_since에 넣어 폴링하세요. 해당 날짜 이후 변경된 항목만 반환됩니다.

curl 'https://www.myhuiban.com/api/conferences?updated_since=2026-08-01&per_page=100'

두 가지를 알아 두세요. 해상도가 하루 단위이므로 가장 최근 날짜를 다시 받아오는 것은 정상이며 멱등합니다. 또한 한 번도 편집된 적 없는 항목은 변경 기록이 없어 전체 조회에만 나타나고 증분 피드에는 포함되지 않습니다.

한도와 상태 코드

  • 200 — 성공. 그날 남은 횟수는 X-Quota-Remaining에서 확인하세요.
  • 401 — 이 엔드포인트에는 자격 증명이 필요합니다(개별 상세 엔드포인트만 해당). 또는 보낸 자격 증명이 유효하지 않거나 폐기·만료되었습니다. 익명 등급을 쓰려면 Authorization 헤더를 아예 보내지 마세요. 사용할 수 없는 자격 증명이 익명 등급으로 자동 강등되는 일은 없습니다.
  • 402 — 계정의 일일 한도를 모두 사용했습니다. 재설정까지 남은 초는 Retry-After 에 표시됩니다.
  • 429 — IP 단위 익명 일일 한도를 모두 사용했습니다. 무료 API 키를 만들면 한도가 크게 올라갑니다. 재설정까지 남은 초는 Retry-After 에 표시되니 그 시간만큼 기다린 뒤 재시도하세요. 예약 작업에는 updated_since 을 사용해 변경된 것만 가져오세요.

클라이언트 예제와 내려받을 수 있는 스냅샷

github.com/sundou82/conference-partner-mcp는 함께 제공되는 공개 저장소입니다. Claude / Cursor / VS Code 용으로 복사해 붙여넣는 MCP 설정, API 키 없이 실행되는 Python / Node / curl 클라이언트, 그리고 매일 본 사이트에서 다시 가져오는 OpenAPI 문서가 들어 있습니다. MCP 서버와 API 자체는 호스팅 서비스이며 오픈 소스가 아닙니다 —— 이를 사용하려고 저장소의 무언가를 설치할 필요는 없습니다.

저장소에는 매일 다시 만들어지는 스냅샷도 JSON과 CSV로 들어 있습니다. 다가오는 마감, CCF와 CORE 목록, CCF 학술지, 진행 중인 특집호 모집, 임팩트 팩터순 학술지입니다. 범위는 위의 자격 증명 없이 쓰는 엔드포인트가 제공하는 것과 정확히 같으며, 개별 상세는 API 뒤에 남아 있습니다. 마감이 바뀌는 순간 파일은 낡으므로 훑어보거나 일괄 적재할 때 쓰고, 정확해야 할 때는 API를 호출하세요.

이용 약관

본 API는 읽기 전용이며 상용 제품을 포함해 무료로 사용할 수 있습니다. 조건은 Conference Partner(회반)를 출처로 밝히고 본 사이트의 해당 페이지로 링크를 다는 것입니다 —— 모든 응답에 들어 있는 detail_page URL이 바로 그 용도입니다. 목록을 크롤링할 때는 초당 1회 이하로 유지해 주세요. 데이터셋을 대량으로 재배포할 때는 직접 크롤링하지 말고 공개된 데이터 스냅샷을 사용하시고, 그보다 넓은 용도 특히 데이터셋 라이선스와 모델 학습 목적은 먼저 문의해 주세요. 등급과 데이터의 출처는 방법론도 참고하세요.

기타 기계 판독 가능한 진입점

질문, 버그 신고, 지원을 원하는 사용 사례는 [email protected]로 보내 주세요.