helallao/perplexity-ai

이 프로젝트가 하는 일

Perplexity AI는 공식 API 키 없이 Perplexity AI 검색 엔진을 프로그래밍 방식으로 쿼리할 수 있는 Python 라이브러리입니다. Perplexity의 내부 웹 엔드포인트를 리버스 엔지니어링하며, Emailnator를 통해 새 Gmail 계정을 생성하여 하루 5회 무료 Pro 쿼리를 재설정하는 브라우저 자동화 도구도 포함합니다.

Perplexity를 위한 비공식적이고 기능이 풍부한 클라이언트로 생각하면 됩니다. 지원하는 기능은 다음과 같습니다:

검색 모드: auto, pro, reasoning, deep research
기본 모델 선택 (예: GPT‑5, Claude 4.5, Grok 등)
문서 Q&A를 위한 파일 업로드
스트리밍 응답
후속 질문
동기 및 비동기 API
계정 생성을 위한 웹 인터페이스 (브라우저 자동화)
MCP(Model Context Protocol) 서버로, Claude Code와 같은 도구가 Perplexity를 검색 백엔드로 사용할 수 있게 함

주요 기능

계정 생성 – Emailnator를 사용하여 일회용 Gmail 계정을 만들어 무료 Pro 쿼리 제한을 갱신합니다.
MCP 서버 – Perplexity 검색을 도구(perplexity_ask, perplexity_research 등)로 MCP 클라이언트(예: Claude Code)에 노출합니다. API 키 없이 쿠키를 사용하여 작동합니다.
유연한 검색 – 모드, 모델, 소스(웹/학술/소셜)를 선택하고, 파일을 업로드하고, 답변을 스트리밍할 수 있습니다.
견고한 오류 처리 및 로깅 – 사용자 정의 예외 및 구조화된 로깅.
비동기 및 동기 API – perplexity(동기) 및 perplexity_async 모듈을 모두 제공합니다.
웹 자동화 – Patchright(탐지되지 않는 Chrome)를 사용하여 실제 브라우저에서 계정 생성 및 사용을 자동화합니다.

작동 방식

이 라이브러리는 Perplexity의 비공개 웹 쿼리 엔드포인트를 활용합니다. 다음 중 하나를 선택할 수 있습니다:

익명으로 사용 (auto 모드로 제한), 또는
자신의 Perplexity 쿠키를 제공하여 pro, reasoning, deep research를 잠금 해제.

무제한 Pro 쿼리를 위해 라이브러리는 Emailnator를 통해 새 Gmail 주소를 자동으로 생성하여 무료 티어 허용량을 매번 재설정합니다.

MCP 서버는 별도 프로세스(stdio 또는 HTTP)로 실행되며 Perplexity를 도구로 노출합니다. 장기 실행 연구 작업을 위해 로컬 SQLite 저널을 유지하며, 지속적인 상태 추적과 우아한 실패 처리를 제공합니다.

주목할 만한 이유

숨겨진 API 주변에 견고한 클라이언트를 구축하는 방법을 보여줍니다. 스트리밍, 파일 업로드, 비동기 지원, 본격적인 MCP 통합을 갖추고 있습니다.
저널 기반 연구 작업 시스템의 포함은 신뢰성을 위한 세심한 엔지니어링(백그라운드 워커, 멱등성, 큐 제한)을 보여줍니다.
제3자 AI 서비스를 MCP를 통해 에이전트 워크플로우에 통합하는 방법을 보여줍니다. 이는 2025년의 뜨거운 주제입니다.

주의 사항

ToS 및 윤리적 우려: 계정 생성 기능은 일회용 계정을 만들어 "무제한 Pro 쿼리"를 실현함으로써 Perplexity의 서비스 약관을 위반할 수 있습니다. 사용에 따른 책임은 본인에게 있습니다.
공식 API 키 불필요 – 그러나 이 접근 방식은 언제든지 변경될 수 있는 엔드포인트를 스크래핑하는 데 의존합니다.
Windows 제한 – 파일 권한 제약으로 인해 연구 저널 MCP 도구는 POSIX 시스템에서만 지원됩니다.

요약하자면: 공식 API 없이 웹 서비스로 할 수 있는 것의 경계를 넓히는 영리하고 잘 설계된 비공식 클라이언트입니다.