CLIAPI

Lên lịch và đăng bài từ terminal

fopost là CLI chính thức của FoPost: một tệp thực thi tĩnh duy nhất, không cần cài thêm gì. Tạo bài viết, đính kèm media, lên lịch cho mọi tài khoản đã kết nối và kiểm tra từng lượt gửi, ngay từ shell, script hoặc tác vụ CI.

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

Một tệp thực thi

macOS, Linux và Windows trên amd64 và arm64. Cài bằng Homebrew, go install hoặc tệp nén bản phát hành.

Dành cho script

Mọi lệnh đều nhận --json, lỗi được ghi ra stderr và mỗi lỗi có mã thoát riêng.

Không có bài đăng bất ngờ

Bài viết vẫn là bản nháp cho đến khi bạn dùng --publish, chạy posts publish hoặc đặt lịch.

Bài viết

Tạo, lên lịch và đăng chỉ bằng một lệnh

posts create nhận tài khoản, nội dung, tệp media cục bộ và thời gian. Tệp được tải lên thư viện media và tự động đính kèm. Nội dung dài có thể lấy từ tệp hoặc pipe, và preflight kiểm tra bài viết với từng mạng đích trước khi gửi bất cứ thứ gì.

Xem các lệnh posts
Bài viết
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

Lên lịch hoặc đăng ngay

Truyền một thời gian để lên lịch, dùng --publish để gửi ngay, hoặc không truyền gì để giữ bản nháp.

Preflight

Xem tài khoản nào sẵn sàng hoặc bị chặn, và lý do, trước khi đăng.

Trạng thái gửi

Trạng thái theo từng tài khoản, số lần thử và liên kết trực tiếp khi mạng đã có.

Viết script

JSON đầu ra, mã thoát đầu vào

Thêm --json vào bất kỳ lệnh nào và chuyển kết quả cho jq. Lỗi 401, 404, giới hạn tốc độ và yêu cầu không hợp lệ đều thoát với mã khác nhau, nên script phân biệt được mà không cần phân tích văn bản. Việc thử lại và giãn cách được xử lý bên dưới ở mọi yêu cầu.

Đọc hướng dẫn viết script
Các tài khoản cần chú ý
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json ở mọi nơi

Chính tài nguyên đó, được thụt lề, trên stdout. Bảng dành cho con người.

Mã thoát riêng biệt

Đầu vào sai, xác thực, phạm vi, không tìm thấy, giới hạn tốc độ và lỗi máy chủ đều có mã riêng.

Tự động thử lại

Giới hạn tốc độ, lỗi máy chủ và lỗi mạng được thử lại với độ trễ tăng dần.

CI

Đăng bài từ pipeline của bạn

Đặt khóa API làm secret, truyền workspace, và CLI không cần cấu hình đã lưu. Thông báo bản phát hành, chia sẻ changelog, hoặc chặn merge khi preflight thất bại. Với GitHub còn có một Action chính thức bao bọc cùng quy trình này.

Bắt đầu xây dựng
Ghi chú phát hành cho mỗi tag
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

Khóa từ môi trường

FOPOST_API_KEY được đọc tự động. Không cần bước đăng nhập trong CI.

Mọi hệ thống CI

GitHub Actions, GitLab CI hoặc bất kỳ hệ thống nào chạy được shell.

Tự động hóa và webhook

Kích hoạt tự động hóa và quản lý đăng ký webhook từ cùng một công cụ.

Giải đáp câu hỏi về CLI

Tôi cài đặt CLI như thế nào?

Chạy brew install fopost/tap/fopost, hoặc go install github.com/fopost/fopost-cli@latest, hoặc tải tệp nén cho nền tảng của bạn từ trang bản phát hành trên GitHub và đặt fopost vào PATH.

Có cần tài khoản không?

Có. CLI làm việc với API FoPost được lưu trữ, nên cần một khóa API, bạn tạo trong bảng điều khiển tại Cài đặt, Khóa API. fopost auth login sẽ lưu khóa, hoặc dùng FOPOST_API_KEY thay thế.

Khóa API của tôi được lưu ở đâu?

Trong thư mục cấu hình người dùng của bạn, chỉ bạn đọc được. CLI không bao giờ in lại khóa: auth status hiển thị tiền tố đã che, và đầu ra chi tiết không bao gồm khóa.

Nó làm được những gì?

Bài viết, tài khoản và tình trạng của chúng, workspace, tải media lên, nhãn, phân tích, tự động hóa và webhook. Chạy fopost --help hoặc đọc tài liệu CLI để xem mọi lệnh.

Có phải mã nguồn mở không?

Có. CLI dùng giấy phép MIT và mã nguồn nằm trên GitHub tại fopost/fopost-cli.

Xây dựng trên CLI ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API của bạn