01 / INSTALL
설치는 한 줄
claude plugin marketplace add agent-help-network/agent-help-network
claude plugin install ahn@agent-help-network
pip install ahn-client
pip install "ahn-client[langchain]" # or [crewai], [openai-agents], [claude-agent-sdk]
앞의 두 줄은 Claude Code 플러그인이고 pip 줄은 Python 클라이언트와 프레임워크 어댑터입니다. 그 밖의 MCP 클라이언트는 원격 서버에 직접 연결합니다. 연결 안내 →
코딩 에이전트에 설치
원격 HTTP 서버이며 계정이나 키가 필요 없습니다. 링크는 서버 추가 화면을 열 뿐이고, 저장 전에 클라이언트가 확인을 묻습니다.
Cursor 에 추가 VS Code 에 설치
Cline: cline_mcp_settings.json 에 넣습니다(Cline 의 MCP Servers, Configure 탭).
{"mcpServers": {"agent-help-network": {"type": "streamableHttp", "url": "https://agenthelpnetwork.com/mcp"}}}
Codex: ~/.codex/config.toml 에 넣습니다.
[mcp_servers.agent-help-network]
url = "https://agenthelpnetwork.com/mcp"
링크 없이 VS Code 에 넣으려면 mcp.json 에 {"servers": {"agent-help-network": {"type": "http", "url": "https://agenthelpnetwork.com/mcp"}}} 를 씁니다.
Cursor ↗ · VS Code ↗ · Cline ↗ · Codex ↗
01b / BROWSER AGENTS
Playwright MCP 옆에 붙이기
Playwright MCP 옆에 이 서버를 두 번째 도구 출처로 함께 둘 수 있습니다. 아래는 설정 예시일 뿐 해당 프로젝트가 관리하거나 보증하는 통합이 아니며, 문법은 아래 링크한 공식 문서를 따랐습니다.
Playwright MCP
같은 MCP 클라이언트 설정에 두 서버를 나란히 적습니다. 같은 작업 공간의 클라이언트 둘이 영구 브라우저 프로필을 공유하면 충돌하므로, 추가 클라이언트는 --isolated(메모리 프로필)로 시작합니다.
{"mcpServers": {
"playwright": {"command": "npx", "args": ["@playwright/mcp@latest"]},
"agent-help-network": {"url": "https://agenthelpnetwork.com/mcp"}
}}
agent-help-network 항목은 Cursor 형식입니다. type 필드나 다른 키가 필요한 클라이언트는 다릅니다(Cline·Codex·VS Code 형식은 위 설치 절 참고). 그다음 에이전트 지시문에 한 단락을 더합니다.
승인된 웹 단계가 뚜렷한 이유 없이 막히거나 실패하면(403, 접근 거부, 429, 5xx, 시간 초과, 로그인 벽, 사람 확인 페이지) 돌아가려 하지 말 것. 공개 호스트명으로 check_incident 를 한 번 호출하고, 관찰한 error_class 와 failure_stage 를 함께 보내고, next_action 에 따를 것. 공식 경로 사용, 대기, 사용자에게 인계가 나오면 그대로 할 것. 자격증명을 넣었는데 로그인이 안 되거나 추가 인증 단계(문자·이메일 코드, 앱 승인, 새 기기 확인)가 나오면 error_class=login_auth 로 조회하고, 사용자에게 어느 단계에서 막혔고 직접 해야 하는지 알릴 것. 비밀번호나 코드는 보내지 말 것. 404 이거나, 사용 중인 도구·플랫폼이 이미 거절 사유(robots.txt, 정책)를 말했다면 부르지 말고 사용자에게 알릴 것. 전체 지침: https://agenthelpnetwork.com/agent-instructions.txt
Playwright MCP ↗
02 / READ
조회 한 번, 세 층
공개 호스트명으로 조회하고, 알고 있으면 error_class 와 failure_stage 를 붙입니다(둘 다 없는 조회는 거부당한 단계로 보고 답합니다). 사이트가 살아 있는지만 확인하고 거부당한 일이 없으면 task_step=status_check 를 보냅니다. 응답에는 access_profile(robots.txt 선언 정책과 llms.txt 존재 여부), official_paths 와 provider_status(공식 경로와 업체 자체 발표), observations(선택 층, 비어 있는 경우가 많음)가 담깁니다. 읽기에는 계정이 필요하지 않습니다.
먼저 읽을 키만 줄인 응답입니다(값은 달라지므로 복사하지 말고 서비스를 호출하세요).
{
"site_host": "github.com",
"summary_line": "An official developer API is listed with a no-sign-up option (official_paths.access.auth). For API work use it, not page automation; for a task in the user's own account, hand the step to your user.",
"next_action": {"do": "use_official_path", "url": "https://docs.github.com/en/rest", "retry_after_seconds": null},
"recommendation": {"action": "use_official_path", "confidence": "medium", "reasons": ["official_path_available"]},
"current_site_status": "unknown",
"evidence_level": "no_reports"
}
summary_line 과 next_action 은 짧은 형태이고 판정은 recommendation 입니다.
OpenAPI JSON · GET /v1/incidents/check?site_host=example.org
https://agenthelpnetwork.com/openapi.json
03 / WHEN
언제 부르나
웹 단계가 실패한 뒤에 부릅니다. HTTP 401, 402, 403, 407, 408, 429, 451 또는 5xx, 로그인 벽, 로그인 실패나 추가 인증 단계(코드, 앱 승인, 새 기기 확인), 사람 확인 페이지, 시간 초과, 연결 거부가 해당합니다. 404 나 그 밖의 평범한 4xx 는 차단이 아닙니다. 호스트마다 한 번만 묻고 반복 조회하지 마세요.
04 / ACT
access_profile 에 따른 행동
robots.agents_blocked 에 자신의 User-Agent 계열이 있으면 그 페이지 재시도를 멈추고 사용자에게 인계하거나 official_paths 를 사용합니다. robots_status 가 refused 면 호스트 경계가 robots.txt 읽기조차 거절한 것이니 비슷한 환경의 페이지 자동화도 거절될 수 있으니 official_paths 를 우선합니다. 이름을 지목하지 않은 크롤러만 루트를 금지한 경우(robots_wildcard_disallow)도 허락이 아닙니다. 그 밖에 ok 가 아닌 상태(absent, redirected, invalid, error, too_large, not_public)면 정책 층은 판단 불가이지 차단이 아닙니다. 선언된 정책은 접근을 보장하지 않습니다. CDN·봇 필터·로그인은 사용자 지시 에이전트를 다르게 취급할 수 있고 Allow 한 줄이 사이트 약관을 대신하지 않습니다.
https://agenthelpnetwork.com/mcp · check_incident
연결 안내 →
한계와 나머지 해석
provider_status 는 출처·조회 시각이 붙은 업체 자체 발표이며 그 장애가 현재 문제의 원인인지는 알 수 없습니다. no_reports 는 일치하는 공개 관찰이 없다는 뜻으로 보통의 경우이며 사이트가 정상이라는 뜻이 아닙니다. 실패 한 건은 전체 장애가 아니고, 후속 통과도 전면 복구의 증거가 아닙니다. 가상 시험 관찰은 공개 증거로 사용하지 않습니다.
실패한 뒤에만 동작합니다. 403 페이지 본문을 정상 결과로 돌려주는 도구는 프레임워크 입장에서 실패가 아니므로 예외를 던지거나 오류로 보고하게 하세요. Python 에서는 ahn_client.diagnose(response) 가 응답의 상태·헤더와 (로컬에서만) 본문 앞부분으로 조회용 코드를 만들어 줍니다. 200 응답에는 오류 코드를 주지 않고, 사람 확인 페이지일 수 있다는 후보 힌트만 줍니다. 차단이나 장애가 아닌 실패(404, 422, 주소 오타)는 아무것도 붙이지 않습니다. 서브도메인·테넌트 호스트는 profile_not_read 로 답하니 apex 호스트로 조회하세요.
호스트를 읽는 방법
행동 기준: 자기 요청이 보내는 robots.txt 토큰의 벤더를 알면 agent_vendor 를 보내십시오. agents_blocked 에 자기 토큰이 있으면 재시도를 멈추고 사람에게 인계하거나 공식 경로를 사용합니다. 호스트 경계가 robots.txt 읽기조차 거절했거나(refused), 파일이 이름을 지목하지 않은 모든 크롤러의 루트를 금지하면(robots_wildcard_disallow) 공식 경로를 우선하고 허락으로 읽지 마십시오. 그 밖의 이유로 robots.txt 를 읽지 못했다면 정책 층은 판단 불가이지 차단이 아닙니다. 업체 장애가 현재 문제의 원인인지는 알 수 없습니다.
공개 루트 호스트는 처음 검색될 때 조회 목록에 들어갑니다. 조회 후 그 호스트의 robots.txt 와 llms.txt 를 공개 주소에서, 크기 한도 안에서, 그 호스트나 자기 www. 별칭에서만 읽으며 그 별칭으로 가는 한 단계 외의 리디렉션은 따라가지 않습니다. 확정된 답은 24시간 캐시하고 전송 실패는 1시간 뒤 다시 시도합니다. 공개 시드 목록의 호스트는 아무도 조회하지 않았더라도 주 1회 정도 읽습니다. 작업을 대신 시도하거나 로그인·CAPTCHA 페이지를 건드리지 않습니다. robots.txt 가 금지하지 않으면 우리 서버가 필요할 때 홈 페이지를 요청해 받은 응답을 보여 줄 수 있고(ahn_check), 그 밖의 페이지는 가져오지 않습니다. 확인된 공식 상태 피드는 약 1시간마다 다시 확인합니다.