개발자 문서

CLI 명령 및 설정

CLI로 API 스키마 확인, JSON 요청 전송, 브라우저 로그인, MCP 연결 설정을 수행하세요.

SosoAPI 팀 검토 · 2026-10-21

명령

설치 버전이 지원하는 플래그는 --help에서 확인하세요. 인수 없이 sosoapi를 실행하면 MCP stdio 서버를 시작합니다. 아래 명령은 셸 파이프라인이 아니므로 각각 실행하세요.

npx sosoapi --help
npx sosoapi auth login
npx sosoapi auth login --no-open
npx sosoapi auth status
npx sosoapi auth refresh
npx sosoapi auth logout

npx sosoapi connect threads
npx sosoapi connect instagram --no-open

npx sosoapi api contract --summary
npx sosoapi api contract --route /studio-api/scheduled-posts/
npx sosoapi api contract

인증 및 권한

JSON stdin으로 API 라우트 호출

HTTP POST를 사용하는 읽기를 포함하여 CLI 공개 허용 목록의 라우트에는 api post를 사용하세요. 고객 텍스트가 셸에 해석되지 않도록 파일 편집기로 요청 본문을 request.json에 저장하세요. http_status와 응답 본문을 확인하세요. 종료 코드 영만으로 API 성공을 입증할 수 없습니다.

이 예제는 Workspace 컨텍스트를 읽습니다. 쓰기 전 작업 스키마를 조회하고 사용할 권한이 있는 대상을 확인하세요. 반환된 ID를 저장하고 시간 초과한 요청을 재시도하기 전에 결과를 확인하세요.

{}

npx sosoapi api post /identity-api/workspace/list < request.json

전체 API 참조

환경 변수

MCP 서버를 실행하는 프로세스에 이 변수를 설정하세요. 선택적 텔레메트리에는 인수, 프롬프트, 결과, 파일 경로가 포함되지 않습니다. 끄려면 SOSOAPI_TELEMETRY=0을 설정하세요. 맞춤 API 주소 사용에는 명시적 동의가 필요하며 CLI는 VICKY_API_KEY를 그 주소로 보내지 않습니다.

CLI 환경
변수	효과
SOSOAPI_TOOL_PROFILE=core	일상 도구; 기본값은 full. 권한을 부여하지 않습니다.
SOSOAPI_OUTPUT_SCHEMAS=1	tools/list에 출력 스키마를 포함합니다. 결과는 이 설정과 관계없이 구조화됩니다.
SOSOAPI_UPLOAD_ROOTS	추가 로컬 미디어 루트. :로 구분합니다(Windows는 ;).
SOSOAPI_TELEMETRY=0	선택적 사용량 보고를 비활성화합니다.
SOSOAPI_DEBUG=1	CLI 실패 스택 추적을 출력합니다. 공유 전에 검토하고 민감 정보를 제거하세요.
VICKY_API_KEY	스크립트/CI용 개인 액세스 토큰입니다. 에이전트에는 OAuth를 권장합니다.
VICKY_API_BASE_URL	맞춤 HTTPS API 기본 주소(localhost는 HTTP 가능). SOSOAPI_ALLOW_CUSTOM_BASE_URL=1도 필요합니다.

신뢰할 수 없는 콘텐츠 처리

댓글과 사용자 이름에는 다른 사람이 작성한 지시가 포함될 수 있습니다. 해당 응답에 CLI는 untrusted_content와 untrusted_notice 라벨 및 stderr 경고를 추가합니다. 콘텐츠를 정제하고 길이도 제한하지만 에이전트는 여전히 이를 작업 권한이 아닌 데이터로 취급해야 합니다.