S-Macro 통합 사용 설명서
[S-Macro v5.3 메인 인터페이스 구성도]
0. 프로그램 인터페이스 구조 (UI Layout)
💡 S-Macro는 복잡한 코딩 없이도 마우스 감지만으로 웹의 모든 요소를 정확히 포착해 제어하며 , 강력한 셀레니움 엔진과 실시간 녹화 기능을 통해 단순 클릭부터 다중 계정 기반의 정교한 타겟팅 작업까지 완벽하게 수행하므로 , 기존의 고가 마케팅 프로그램을 완벽히 대체하여 쇼핑몰 데이터 수집이나 반복적인 홍보 업무를 나만의 시나리오로 자유롭게 자동화할 수 있는 혁신적인 도구입니다.
| 영역명 (Region) | 기능 설명 (Description) |
|---|---|
| Scenario Builder (시나리오 빌더) |
매크로의 실행 순서와 동작 리스트를 한눈에 관리하는 메인 ListView 영역입니다. 각 액션의 타입, 타겟, 지연 시간 등을 실시간으로 편집할 수 있습니다. |
| Action Configuration (액션 설정부) |
명령어 종류(Action Type), 제어 대상(Target), 입력 값(Value) 등을 설정합니다. 드롭다운 메뉴를 통해 매크로/논리/웹자동화 명령을 선택하여 시나리오를 구성합니다. |
| Control Panel (제어 패널) |
매크로의 Start/Stop을 제어하며, 전체 반복 횟수(Total Repeat)와 현재 진행 상태를 설정합니다. 실행 중인 시나리오의 무결성을 검사하고 구동을 시작하는 핵심 장치입니다. |
| Element Analyzer (요소 분석기) |
웹 브라우저 내의 요소를 실시간으로 탐색하여 XPath 주소와 태그 정보를 추출합니다. 분석된 데이터는 설정부의 타겟(Target)으로 즉시 전송됩니다. |
| Variable Manager (변수 관리자) |
CSV 파일을 로드하거나 사용자 변수(User Variables)를 관리합니다. 시나리오 내에서 동적인 데이터를 처리하기 위한 매핑(Mapping) 작업을 수행합니다. |
| Status Bar (상태 표시줄) |
프로그램 하단에서 현재 수행 중인 액션, 남은 반복 횟수, 시스템 에러 메시지 등을 실시간으로 피드백(Feedback)합니다. |
💡 팁: Ctrl + F 를 눌러 원하는 키워드(예: 이미지, 클릭, 반복)를 검색하세요.
1. 핵심 기능 요약 (Quick Start)
| 기능 | 메뉴얼 링크 |
|---|---|
| 웹 자동화 | 크롬 브라우저를 직접 제어하여 클릭, 입력, 이동, 스크롤 등을 수행합니다. (Selenium 기반) |
| 이미지 인식 | 화면에서 특정 이미지를 찾아 클릭하거나, 이미지가 나타날 때까지 기다립니다. |
| 실시간 녹화 | 마우스의 휠, 드래그, 키보드 입력 등 실제 사용자의 동작을 그대로 기록하여 재현합니다. |
| 조건문/반복문 | 특정 상황(이미지 발견, 숫자 비교)에 따라 다른 행동을 하거나 작업을 반복합니다. |
| 서브 호출 | 복잡한 작업을 여러 파일로 나누어 관리하고, 필요할 때 불러와서 쓸 수 있습니다. |
2. 액션 명령어 상세 (Action List)
2-1. 매크로 명령어
| 명령어 (Type) | 상세 설명 및 활용법 |
|---|---|
| MouseClick 클릭 |
웹페이지 상의 특정 요소(버튼, 링크, 배너 등)를 클릭합니다. * 방식: XPath(웹 경로)를 자동으로 감지하여 클릭하므로 해상도가 바뀌어도 정확합니다. 👉 마우스 클릭 가이드 보기 |
| Image_Click 이미지 |
화면에서 미리 캡처해둔 이미지를 찾아 클릭합니다. 👉 이미지 클릭 가이드 보기 |
| Image_Search 이미지확인 |
이미지가 화면에 있는지 확인만 합니다. (클릭 안 함) 👉 이미지 서치 가이드 보기 |
| 키보드 입력 키입력 |
텍스트나 특수키({Enter}, {Tab} 등)를 전송합니다. 👉 키보드 입력 가이드 보기 |
| Wait 대기 |
지정한 시간만큼 아무것도 안 하고 기다립니다. (단위: 1000 = 1초) |
| 실시간녹화 녹화 |
사용자의 마우스와 키보드 움직임을 그대로 기록하여 시나리오에 반영합니다. 👉 실시간 녹화 가이드 보기 |
2-2. 논리 명령어
| 명령어 (Type) | 상세 설명 및 활용법 |
|---|---|
| [Loop Start] 반복 |
여기서부터 [Loop End]까지의 구간을 지정한 횟수만큼 반복합니다. 👉 반복문 활용 가이드 보기 |
| [Loop End] 반복종료 |
지정된 반복 구간의 끝을 알립니다. |
| [If Start] 조건 |
조건이 맞을 때만 구간 내용을 실행합니다. 👉 조건문 활용 가이드 보기 |
| [If End] 조건종료 |
지정된 조건 구간의 끝을 알립니다. |
| [계산] 연산 |
변수끼리 사칙연산을 수행하여 {합계}에 저장합니다. 👉 변수 계산 가이드 보기 |
| Label 라벨 |
특정 위치에 이름을 꽂아 GoTo 명령으로 점프할 수 있게 합니다. 👉 라벨/이동 가이드 보기 |
| GoTo 이동 |
지정한 Label 위치로 즉시 이동합니다. 👉 라벨/이동 가이드 보기 |
| Call_Sub 함수 호출 |
다른 시나리오 파일을 불러와서 실행합니다. 👉 서브 호출 가이드 보기 |
| MsgBox 알림 |
화면 중앙에 메시지 창을 띄우고 작업을 일시 정지합니다. 👉 알림창 가이드 보기 |
2-3. 웹자동화 명령어
| 명령어 (Type) | 상세 설명 및 활용법 |
|---|---|
| Link 이동 |
특정 웹사이트 주소(URL)로 이동합니다. 👉 웹 주소 가기 활용법 보기 |
| click 웹클릭 |
XPath를 사용하여 특정 웹 요소를 정확히 클릭합니다. 👉 웹 요소 클릭 가이드 보기 |
| Input 입력 |
웹페이지의 입력창에 글자를 입력합니다. 👉 입력 액션 가이드 보기 |
| Text_click 글자클릭 |
화면에 보이는 '글자'를 찾아서 클릭합니다. 👉 텍스트 클릭 가이드 보기 |
| Scroll 스크롤 |
화면을 아래로 스크롤하여 더 많은 내용을 로딩합니다. |
| Refresh 새로고침 |
현재 웹페이지를 새로고침합니다. |
| RegEx_Scrap 정규식 |
페이지 소스에서 원하는 패턴의 글자만 쏙 뽑아냅니다. 👉 정규식 추출 가이드 보기 |
| 크롬열기 브라우저 |
깨끗한 크롬 브라우저를 실행합니다. |
| 크롬끄기 종료 |
현재 제어 중인 크롬 브라우저를 종료합니다. |
3. 변수 시스템 (Variable System)
변수는 데이터를 담는 그릇입니다. 프로그램 전체에서 이 그릇의 이름을 부르면, 그 안에 담긴 내용물을 꺼내줍니다.
3-1. 시스템 예약 변수 (System Variables)
{1}, {2}, {3}... : CSV 파일의 n번째 컬럼 값 (헤더가 없을 때)
{아이디}, {비밀번호}... : CSV 파일의 헤더 이름으로 값 호출
{LoopIndex} : 현재 반복문이 몇 바퀴째인지 (1, 2, 3...)
{A_Index} : 현재 리스트뷰의 전체 실행 횟수
{Img_found} : 이미지 서치 결과 (1=성공, 0=실패)
{RegEx_Result} : 정규식 추출 결과가 담기는 곳
{전달값1} ~ {전달값10} : 서브 호출(Call_Sub) 시 외부에서 받아온 데이터
{아이디}, {비밀번호}... : CSV 파일의 헤더 이름으로 값 호출
{LoopIndex} : 현재 반복문이 몇 바퀴째인지 (1, 2, 3...)
{A_Index} : 현재 리스트뷰의 전체 실행 횟수
{Img_found} : 이미지 서치 결과 (1=성공, 0=실패)
{RegEx_Result} : 정규식 추출 결과가 담기는 곳
{전달값1} ~ {전달값10} : 서브 호출(Call_Sub) 시 외부에서 받아온 데이터
3-2. 사용자 변수 (User Variables)
사용자가 직접 값을 넣고 뺄 수 있는 변수입니다. 사용자변수 관리자 메뉴에서 설정합니다.
{사용자변수1} ~ {사용자변수10}
- 서브 시나리오(Call_Sub)를 사용할 때, 이 변수들이 {전달값1}, {전달값2}로 매핑되어 전달됩니다.
4. 자주 묻는 질문 (FAQ)
Q1. 크롬 창이 안 열려요.
A. 크롬 드라이버 버전이 현재 설치된 크롬 브라우저 버전과 맞아야 합니다. 최신 chromedriver.exe를 확인하세요.
Q2. 클릭이 안 되고 멈춰요.
A. 페이지 로딩 대기 시간이 부족할 수 있습니다. Wait 액션을 적절히 활용하세요.