T-Flow 설치 & 시작 가이드

0시작 전 준비물

크롬(또는 엣지) 브라우저 — 확장은 크롬 기반에서 동작합니다
티스토리 계정 (발행할 블로그 관리자)
LLM API 키 (Gemini 또는 OpenAI 중 1개 이상 — 원고/카피 생성용)
OpenRouter API 키 (선택 — 주제찾기 · 메모 생성 · 링크 문구 생성용)
네이버 API 키 (선택 — 주제찾기 검색량·트렌드 분석용 · 데이터랩 + 검색광고, 무료)
카카오 REST API 키 (선택 — 경쟁글 벤치마킹용 · 다음 검색 기준, 무료)
승인받을 이메일 (라이선스 계정 승인용)

1확장 다운로드

마이페이지에서 T-Flow 확장 파일을 받습니다.

마이페이지 → T-Flow → 확장 다운로드 클릭

T-Flow.zip 파일이 받아집니다.

받은 ZIP을 압축 해제합니다

바탕화면 등 안 지울 위치에 풀어주세요. 이 폴더를 지우면 확장도 사라집니다.

T-Flow/ ← 이 폴더를 통째로 로드합니다
  ├── manifest.json
  ├── sidepanel.html / sidepanel.js / content.js
  ├── background.js
  └── icons/ · fonts/

2크롬에 설치 (압축해제 로드)

웹스토어가 아니라, 받은 폴더를 크롬에 직접 등록합니다.

크롬 주소창에 chrome://extensions 입력 후 이동

우측 상단 개발자 모드 스위치를 켜기

좌측 상단 압축해제된 확장 프로그램 로드 클릭

1단계에서 압축 푼 T-Flow 폴더 선택

폴더 안이 아니라 manifest.json이 들어있는 폴더 자체를 선택하세요.

확장 목록에 T-Flow가 뜨면 완료. 브라우저 우측 상단 확장 아이콘(퍼즐)에서 T-Flow를 고정하세요.

T-Flow 아이콘 클릭 → 우측에 사이드패널이 열립니다

chrome://extensions — 우측 상단 [개발자 모드] 켜기 → 좌측 상단 [압축해제된 확장 프로그램 로드] 클릭

확장 프로그램 페이지에서 개발자 모드 켜고 압축해제된 확장 프로그램 로드

주소창 입력 대신 — 우측 상단 퍼즐 아이콘 → 확장 프로그램 관리로도 이 페이지를 열 수 있습니다

크롬 켤 때 "개발자 모드 확장 사용 중지" 알림이 떠도 무시하세요

웹스토어 외부 확장이라 크롬이 안내를 띄웁니다. 사용 중지를 누르지 말고 닫으면 계속 사용됩니다. 업데이트가 나오면 새 ZIP을 받아 같은 폴더에 덮어쓴 뒤 확장 목록에서 새로고침(↻)만 누르면 됩니다.

3API 키 발급받기

원고·카피 생성에 AI를 쓰므로 API 키가 필요합니다. Gemini 하나면 바로 시작할 수 있고(무료 등급 제공), 나머지는 선택입니다. 발급한 키는 다음 단계 설정 탭에 붙여넣습니다.

① Gemini API 키 필수 · 무료 시작

원고·썸네일 카피 생성용. 무료 등급으로도 충분히 시작할 수 있습니다.

aistudio.google.com/apikey 접속 후 구글 계정 로그인

API 키 만들기(Create API key) 클릭 → 프로젝트 선택(없으면 자동 생성)

생성된 키(AIza…)를 복사

이 키를 다음 단계 설정 탭의 Gemini API Key에 붙여넣습니다.

② OpenAI API 키 (선택 · GPT로 쓰고 싶을 때)

GPT 모델로 원고·카피를 쓰고 싶을 때. 결제수단 등록이 필요한 유료 서비스입니다.

platform.openai.com/api-keys 접속 후 로그인

Create new secret key 클릭 → 이름 입력 후 생성

키(sk-…)를 복사 (한 번만 보이니 바로 저장)

Billing에서 결제수단·크레딧이 있어야 호출됩니다.

③ OpenRouter API 키 (선택 · 주제찾기·메모·링크문구)

주제찾기, 추가 메모 생성, CTA 링크 읽고 문구 생성에 쓰입니다(Perplexity 검색).

openrouter.ai/keys 접속 후 로그인

Create Key 클릭 → 이름 입력 후 생성

키(sk-or-…)를 복사

pplx-로 시작하는 Perplexity 키가 아니라 sk-or- OpenRouter 키여야 합니다.

크레딧 충전 — OpenRouter는 사용한 만큼 차감되는 유료 API입니다. Credits 메뉴 → Add Credits에서 충전하세요.

충전은 $15 단위를 추천

충전 시 결제 수수료가 붙는데, 소액을 자주 충전할수록 수수료 비율이 커집니다(고정 수수료 때문). $15 충전 시 수수료가 약 $0.89(약 6%)로, 소액 충전보다 크레딧 대비 효율이 좋습니다. 주제찾기·니즈 조사·링크 문구 정도는 $15로도 오래 씁니다.

Add Credits → Amount에 15 입력 — 수수료 $0.89, 합계 $15.89

④ Pollinations API 키 (선택 · 이미지)

본문·썸네일 이미지 무료 생성 서비스입니다. 키 없이도 동작하며, 키 입력 시 우선 사용됩니다.

pollinations.ai 접속

발급받은 토큰을 설정 탭 Pollinations API Key에 붙여넣기

키가 없어도 무료로 동작하니, 비워둬도 됩니다.

⑤ 네이버 데이터랩 · 검색광고 키 (선택 · 주제찾기 검색량·트렌드)

주제찾기 탭의 월 검색량 · 연관 키워드 · 검색어 트렌드에 쓰이는 네이버 키 5가지입니다. 모두 무료로 발급됩니다. 발급 절차는 아래 전용 가이드를 그대로 따라주세요.

네이버 키 5개 발급 방법 보기 →

발급받은 값은 T-Flow 설정 탭에 아래 이름으로 넣습니다:

· 가이드 Step1 Client ID → DataLab Client ID
· 가이드 Step1 Client Secret → DataLab Client Secret
· 가이드 Step2 CUSTOMER_ID → 검색광고 Customer ID
· 가이드 Step2 엑세스라이선스 → 검색광고 API Key
· 가이드 Step2 비밀키 → 검색광고 Secret Key

⑥ 카카오 REST API 키 (선택 · 경쟁글 벤치마킹)

주제찾기 탭의 경쟁글 벤치마킹(다음 검색 상위 노출 글 가져오기)에 쓰입니다. 무료이며 심사 없이 2분이면 발급됩니다.

developers.kakao.com 접속 → 카카오 계정으로 로그인

상단 내 애플리케이션 → 애플리케이션 추가하기

앱 이름과 사업자명 입력 후 저장

개인이면 사업자명 칸에 본인 이름이나 닉네임을 넣으면 됩니다.

생성된 앱 클릭 → 좌측 앱 키 메뉴

REST API 키를 복사해 설정 탭 Kakao REST API Key에 붙여넣기

검색 API는 별도 신청·심사가 없습니다. 플랫폼 등록이나 카카오 로그인 설정도 하지 않아도 됩니다.

API 사용료 안내

키는 각자 발급하고, 사용량만큼 해당 서비스에 요금이 부과됩니다(Gemini는 무료 등급으로 시작 가능). 네이버 데이터랩·검색광고 API는 무료입니다. 모든 키는 내 브라우저에만 저장되며 서버로 보내지 않습니다.

4준비 설정 (설정 탭)

사이드패널 상단 설정 탭에서 아래를 입력하고 저장하세요. 모든 키는 내 브라우저에만 저장됩니다(BYOK).

관리 블로그

발행할 티스토리 블로그 아이디를 한 줄에 하나씩. (예: myblog → myblog.tistory.com)

Gemini / OpenAI API 키

원고 · 썸네일 카피 생성용. 둘 중 하나 이상 필요합니다.

Google AI Studio · OpenAI에서 발급

OpenRouter API 키 (선택)

주제찾기 · 추가 메모 생성 · CTA 링크 읽고 문구 생성에 쓰입니다.

OpenRouter에서 발급 (sk-or-로 시작)

네이버 데이터랩 / 검색광고 키 (선택 · 주제찾기)

주제찾기 탭의 검색량 · 연관검색어 · 검색어 트렌드 분석용. DataLab Client ID · Secret(트렌드)과 검색광고 Customer ID · API Key · Secret Key(검색량) 총 5가지를 입력합니다.

발급 방법: 네이버 키 5개 발급 가이드 (위 3단계 ⑤ 참고)

Kakao REST API 키 (선택 · 경쟁글 벤치마킹)

주제찾기 탭의 경쟁글 벤치마킹용. 다음 검색 상위 노출 글을 가져와 참고합니다. 무료입니다.

발급 방법: developers.kakao.com → 내 애플리케이션 → 앱 키 → REST API 키 (위 3단계 ⑥ 참고)

링크 / CTA (선택)

CTA 버튼 링크 URL만 넣고 문구를 비우면, 글 주제에 맞는 버튼 문구가 자동 생성됩니다. [링크 읽고 문구 생성] 버튼으로 링크 페이지 내용 기반 문구도 만들 수 있습니다.

5계정 승인 받기

발행 기능은 관리자 승인을 받은 이메일만 사용할 수 있습니다.

설정 탭 라이선스에 닉네임과 승인받을 이메일 입력

[승인 요청 / 상태 확인] 버튼 클릭

이미 승인된 이메일이면 즉시 "승인됨"이 뜹니다. 아니면 승인 요청이 관리자에게 전송됩니다.

관리자 승인 대기 (오픈채팅으로 알려주시면 빠릅니다)

승인 후 같은 버튼을 다시 눌러 승인됨 확인 → 발행 가능

발행할 때마다 서버에서 승인 상태를 확인합니다

승인 이메일이 없거나 차단되면 발행이 막힙니다. 상단 자물쇠 아이콘이 초록 체크로 바뀌면 승인 완료 상태입니다.

↻업데이트 방법 (기능 추가 시)

새 기능이 추가되면 마이페이지에서 최신 파일을 받아 교체합니다. 같은 폴더에 덮어써야 저장된 API 키·승인이 그대로 유지됩니다.

마이페이지 → T-Flow → 다운로드로 최신 T-Flow.zip 받기

받은 ZIP의 압축을 풀고, 나온 파일들을 처음 설치했던 그 T-Flow 폴더에 그대로 덮어쓰기

★새 위치에 풀지 말고 기존 폴더에 덮어써야 합니다. 폴더 위치가 바뀌면 저장된 API 키·설정이 초기화됩니다.

크롬 주소창에 chrome://extensions 입력 → T-Flow 카드의 새로고침(↻) 아이콘 클릭

끝. 버전이 올라가고 새 기능이 적용됩니다.

T-Flow 카드 우측 하단 새로고침(↻) 아이콘 — 파일을 덮어쓴 뒤 이걸 눌러야 새 버전이 적용됩니다

설정(API 키)이 사라졌다면?

기존 폴더가 아닌 새 폴더에서 로드하면 확장이 새 것으로 인식되어 API 키·승인이 비워집니다. 그 경우 설정 탭에서 키를 다시 입력하고 저장하면 됩니다.

✓설치 완료!

이제 글생성 탭에서 주제를 넣고 원고를 생성해보세요. 자세한 사용법은 사용 가이드를 참고하세요.

확장 압축해제 로드 완료
티스토리에 로그인된 상태 (브라우저 세션 사용)
API 키 입력 및 저장 완료
라이선스 이메일 승인 완료 (자물쇠 초록 체크)

탭별 사용 & 튜닝 가이드 →