megastudy-letter.js

메가스터디 학부모편지(부모님편지) 서비스를 자동화하는 Node.js용 라이브러리/CLI입니다.

지원 기능:

• 메가스터디 계정 로그인(ID/비번)
• 부모님편지 게시판 목록 조회
• 부모님편지 작성/게시

기본 대상은 seochob.megastudy.net 이지만, 지점별로 *.megastudy.net 형태로 호스트만 바꾸면 동작하도록 설계했습니다.

설치

npm install megastudy-letter

라이브러리 사용법

import MegastudyLetterClient from 'megastudy-letter';

const client = new MegastudyLetterClient({ host: 'seochob.megastudy.net' });

await client.login({ userId: '아이디', password: '비밀번호' });

// 게시판 목록 조회 (전체글/내글)
const all = await client.listParentLetters({ listMode: 'Y', page: 1 });
const mine = await client.listParentLetters({ listMode: 'N', page: 1 });

// 반(담임) 목록 조회 (글쓰기 폼의 sclass 옵션)
const classes = await client.getClassList();

// 편지 작성/게시
await client.postParentLetter({
  receiver: '학생 이름',
  classId: classes[0]?.value ?? '1484',
  writer: '보내는 사람 이름',
  relation: '관계(예: 부/모/본인)',
  title: '제목',
  content: '내용',
});

CLI 사용법

# 로그인 확인
megastudy-letter login --host seochob.megastudy.net --userid <id> --passwd <pw>

# 게시판 목록 조회
megastudy-letter list --host seochob.megastudy.net --userid <id> --passwd <pw> --mode all --page 1
megastudy-letter list --host seochob.megastudy.net --userid <id> --passwd <pw> --mode mine --page 1 --json

# 반 목록 조회
megastudy-letter classes --host seochob.megastudy.net --userid <id> --passwd <pw>

# 편지 게시
megastudy-letter post --host seochob.megastudy.net --userid <id> --passwd <pw> --class 1484 --title "제목" --content-file ./newsletter.txt

환경변수로도 지정할 수 있습니다:

• MEGASTUDY_USERID
• MEGASTUDY_PASSWD

개발

npm install
npm run build
npm run dev
npm run lint
npm run format
npm run clean

License

MIT