Community라이팅 & 에디팅github.com

Deco BE85

TP-Link Deco BE85 라우터를 위한 로컬 API 래퍼입니다. Wi-Fi 설정, 연결된 클라이언트 조회, 재부팅 등의 작업을 수행할 수 있습니다.

Deco BE85란 무엇인가요?

이 스킬은 TP-Link Deco BE85 메시 Wi-Fi 라우터를 FastAPI 기반 로컬 API를 통해 제어할 수 있는 Agent Skill입니다. `https://deco.msageha.net/api`를 기본 URL로 사용하며, 서버 자체에 저장된 자격 증명으로 라우터에 로그인하므로 클라이언트 측 인증이 필요하지 않습니다. 대시보드 조회, 연결된 클라이언트 목록 확인, Wi-Fi 대역별 ON/OFF, SSID/비밀번호 변경, 채널 설정, WAN/LAN/IPv6 상태 확인, CPU/메모리 사용량 모니터링, 유닛 재부팅 등 다양한 작업을 지원합니다. 특히 쓰기 작업(Wi-Fi 설정 변경, 재부팅 등)은 사용자 확인 후에만 수행하도록 설계되어 있으며, 라우터 인증 실패(401), 라우터 측 오류(502), 연결 불가(504) 등의 오류 상황에 대한 설명이 포함되어 있습니다. Claude Code, Cursor, Codex, Antigravity 등의 AI 에이전트 플랫폼과 호환됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add msageha/skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Deco BE85은(는) 무엇을 하나요?

기본 URL: https://deco.msageha.net/api (TP-Link Deco BE85 로컬 API용 FastAPI 래퍼). 이 인스턴스로의 요청에는 인증 헤더나 쿠키가 필요하지 않습니다. 서버가 저장된 자격 증명을 사용하여 라우터에 직접 로그인합니다.

중요 사항

  • 라우터 로그인은 지연(lazy) 방식입니다: 시작 후 또는 유휴 상태 후 첫 번째 호출이 로그인을 트리거하며 속도가 느립니다. 만료된 세션은 자동으로 다시 로그인하여 재시도됩니다.
  • 요청은 서버 측 락(단일 라우터 세션) 뒤에서 직렬화됩니다. 엔드포인트를 순차적으로 호출하고, 병렬 요청은 사용하지 마십시오.
  • band는 band2_4 / band5_1 / band6이고, network는 host / guest입니다.
  • GET /wireless는 ssid/password를 base64로 인코딩하여 반환합니다. 쓰기 엔드포인트는 일반 텍스트로 받습니다 (서버가 인코딩합니다).
  • 쓰기 작업 전에 사용자 확인을 받으십시오: Wi-Fi 토글/설정 변경은 해당 대역의 클라이언트를 일시적으로 연결 해제하며, POST /reboot (confirm: true 필요)는 전체 네트워크를 몇 분 동안 중단시키고, POST /raw (읽기 전용이 아닌 operation 포함)는 라우터 설정을 임의로 변경할 수 있습니다.
  • 오류: 401 라우터 인증 실패, 502 라우터 측 오류 (detail + error_code 포함), 504 라우터 연결 불가, 400/422 요청 검증 실패.

핵심 작업

작업엔드포인트
개요 (WAN/CPU/메모리/노드 및 클라이언트 수)GET /dashboard
Deco 유닛 (메시 노드)GET /devices
연결된 클라이언트GET /clients?online_only=true
차단된 클라이언트GET /clients/blocked
Wi-Fi 설정 (모든 대역, 호스트/게스트)GET /wireless
대역별 Wi-Fi ON/OFFPOST /wireless
SSID/비밀번호/채널 등 변경POST /wireless/config
WAN / 인터넷 / LAN / IPv6 상태GET /network/wan, /network/internet, /network/lan, /network/ipv6
CPU / 메모리 사용량GET /network/performance
Deco 유닛 재부팅 (파괴적 작업)POST /reboot
기타 Deco 엔드포인트 (탈출구)POST /raw
서버 상태 / 명시적 로그인GET /health, POST /login, POST /logout

전체 요청/응답 스키마 및 실행 가능한 curl 예제: references/api-reference.md 및 references/commands.md를 참조하십시오.

관련 스킬