Viết bài bằng AI của riêng bạn qua MCP

Công cụ nội dung có thêm một người viết thứ hai: chính AI của bạn. Bất kỳ MCP client nào đã đăng nhập vào AutoPSEO, chẳng hạn Claude Code, các ứng dụng Claude hoặc Cursor, đều có thể lấy chủ đề từ cùng một hàng đợi, đọc cùng brief và quy tắc, rồi gửi bản nháp vượt qua đúng những bước kiểm tra như trình viết của AutoPSEO. Các bản nháp viết theo cách này không tính vào hạn mức bài viết hằng tháng. Bạn có thể làm việc với AI trong một cuộc trò chuyện, hoặc để một lượt chạy không cần giám sát viết bài theo lịch.

Kết nối AI của bạn

Endpoint MCP là https://app.autopseo.com/mcp. Có hai cách kết nối, đều nằm ở trang MCP & API trong tài khoản của bạn:

• Đăng nhập bằng OAuth trong mục "Kết nối bằng cách đăng nhập". Với Claude Code: claude mcp add --transport http autopseo https://app.autopseo.com/mcp, sau đó chạy /mcp và chọn Authenticate.
• Khóa API bắt đầu bằng apk_live_, gửi dưới dạng Authorization: Bearer <key>. Các công cụ nội dung có thay đổi dữ liệu cần khóa Đọc và ghi; khóa Chỉ đọc chỉ dùng được các công cụ đọc.

Vai trò của bạn cũng quan trọng: thành viên chỉ có quyền xem chỉ dùng được các công cụ đọc, và thành viên chỉ được mời vào một số property thì chỉ thấy các property đó. Danh mục đầy đủ, bao gồm các công cụ Search Console, nằm ở trang MCP; phần quản lý khóa nằm trong MCP & ChatGPT app.

Trong Cài đặt của trang Nội dung, mục Ai viết các chủ đề trong hàng đợi quyết định ai xử lý hàng đợi: AutoPSEO, theo nhịp đã đặt ở trên hoặc AI của riêng bạn, qua MCP. Khi chọn AI của riêng bạn, trình viết của AutoPSEO sẽ ngừng nhận các tác vụ trong hàng đợi. Dù chọn cách nào, "AI của riêng bạn vẫn có thể viết và viết lại bài bất cứ lúc nào, bất kể bạn chọn gì ở đây." Để nhận và gửi bài, công cụ nội dung phải được bật cho property và gói dịch vụ phải còn hiệu lực.

Các công cụ nội dung

Khóa chỉ đọc, hoặc thành viên chỉ có quyền xem, sẽ bị từ chối ở mọi công cụ không thuộc nhóm đọc. Các công cụ xuất bản, gỡ bài, gộp bài hoặc xóa đường dẫn sẽ yêu cầu AI chỉ hành động khi bạn đồng ý.

Viết một bài

1. Chọn một tác vụ. content_list_tasks cho thấy những gì đang trong hàng đợi; content_find_pages kiểm tra xem site của bạn đã có nội dung về chủ đề đó chưa.
2. Nhận tác vụ. content_claim { taskId } giữ tác vụ trong hai giờ, và nhận lại sẽ gia hạn thời gian giữ. Bạn cũng có thể nhận một bài đang hiển thị bằng pageId và kind, hoặc bắt đầu từ một từ khóa, có thể kèm khóa loại nội dung. Từ khóa sẽ đi qua các bước lọc trước.
3. Đọc brief. content_get_brief trả về rules (cùng bộ quy tắc viết mà trình viết của AutoPSEO nhận được), brief, allowedLinks và cover.wanted. Lần gọi đầu tiên sẽ nghiên cứu kết quả tìm kiếm và tốn tín dụng nghiên cứu; các lần gọi sau cho cùng tác vụ đều miễn phí.
4. Viết và gửi. Gửi bài viết dưới dạng JSON theo định dạng mô tả trong phần giao nội dung bằng content_submit. Nếu bài không qua một bước kiểm tra, phản hồi sẽ bắt đầu bằng "Not saved. Fix these and submit again:" kèm danh sách lỗi; các liên kết nằm ngoài allowedLinks sẽ bị chuyển thành chữ in đậm. Khi tác vụ thay đổi một bài đang hiển thị, hãy truyền baseRev, tức bản sửa đổi bạn đã dựa vào để làm việc; nếu bài đã thay đổi từ đó, lần gửi sẽ bị từ chối vì xung đột.
5. Dịch. Với mỗi ngôn ngữ khác, dùng content_get_translation, rồi content_submit_translation. Có thể gửi các ngôn ngữ song song. Xem phần dịch thuật.
6. Thêm ảnh bìa khi brief cho biết cần ảnh bìa (xem bên dưới).
7. Xuất bản. Bản nháp chờ ở trạng thái duyệt. content_publish { taskId } sẽ duyệt bản nháp, và công cụ này chỉ dùng khi bạn cho phép.

Khi thời gian giữ hết hạn, lịch chạy mỗi năm phút sẽ giải phóng tác vụ: tác vụ quay lại hàng đợi. content_decline từ chối vĩnh viễn một tác vụ với lý do dài từ 3 đến 300 ký tự, nên tác vụ đó sẽ không bao giờ được đề xuất lại.

Chỉnh sửa bản nháp đang chờ duyệt

Khi người duyệt yêu cầu thay đổi, bạn không cần phải từ chối bản nháp:

1. content_claim với tác vụ (hoặc trang, hoặc từ khóa) đưa bản nháp của bạn trở lại trạng thái đang viết, để không ai xuất bản nó trong lúc đó.
2. content_get_page trả về bản nháp dưới dạng draft.
3. content_submit lưu bản sửa đổi tiếp theo tại cùng địa chỉ và đánh dấu bản nháp cũ là đã được thay thế.
4. Gửi lại các bản dịch: bản sửa đổi mới chỉ chứa ngôn ngữ của chính nó, và content_get_translation đưa bản dịch của bản nháp bị thay thế vào current.

Nếu thời gian giữ hết trước khi bạn xong, bản nháp sẽ quay lại trạng thái chờ duyệt, không thay đổi.

Prompt

Máy chủ cũng cung cấp các prompt, xuất hiện trong Claude Code dưới dạng lệnh slash như /mcp__autopseo__write-articles:

Ảnh bìa từ AI của riêng bạn

Khi site của bạn hiển thị ảnh bìa, content_get_brief trả về cover.wanted. AI của bạn có thể giao một ảnh do nó tạo ra qua cover của content_submit (một url https, hoặc data base64 tối đa 2.5 MB), dùng PUT để tải tệp lên coverUploadUrl mà content_submit trả về, hoặc đặt ảnh sau đó bằng content_set_cover. AI cũng có thể tạo ảnh từ prompt riêng của AutoPSEO bằng content_cover. Định dạng, kích thước và các bước kiểm tra nằm trong phần ảnh bìa.

Chi phí

• Bản nháp và bản dịch từ AI của riêng bạn không tính vào hạn mức bài viết hằng tháng, và việc gửi chúng là miễn phí.
• Lần xem đầu tiên của brief đối với kết quả tìm kiếm, và lệnh gọi mô hình để chọn loại nội dung cho một từ khóa phù hợp với hai loại, sẽ dùng tín dụng nghiên cứu.
• Thêm chủ đề, từ chối tác vụ và các công cụ đọc đều miễn phí. Việc duyệt một bản nháp còn thiếu ngôn ngữ, trên site mà AutoPSEO phụ trách dịch, sẽ bắt đầu các bản dịch bằng tín dụng nghiên cứu.

Chạy không cần giám sát trên máy Mac

content_instructions trả về mọi việc mà một lượt chạy không cần giám sát nên làm cho một property: báo cáo, hoàn tất phần việc lượt chạy trước để lại, kiểm tra mức độ bao phủ trước khi tốn chi phí cho brief, từ chối các chủ đề trùng lặp, viết, dịch, thêm ảnh bìa, và chỉ xuất bản khi chế độ duyệt của site đang tắt. Lượt chạy không bao giờ gỡ bài hay khôi phục bản cũ, và kết thúc bằng một dòng mà script có thể đọc:

AUTOPSEO_RESULT property=<id> published=<n> review=<n> declined=<n> failed=<n> values=<n>

Trình viết AutoPSEO là một bộ nhỏ các script macOS chạy quy trình này bằng Claude Code của chính bạn, dùng gói đăng ký Claude của bạn, dưới launchd. Liên hệ chúng tôi để nhận bộ script. Cách cài đặt:

1. Kết nối Claude Code với AutoPSEO (bằng connector trong Claude, hoặc claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp rồi chọn Authenticate trong /mcp).
2. Chạy ./install.sh. Lệnh này tạo ~/.autopseo/ gồm run.sh, cover-mcp.mjs và một tệp writer.json mẫu, cùng một job launchd chạy hằng ngày lúc 15:07 (có thể đổi bằng AUTOPSEO_HOUR và AUTOPSEO_MINUTE). Job này chưa được nạp.
3. Điền ~/.autopseo/writer.json: properties (mỗi mục có id, kèm limit tùy chọn là số bài mới mỗi lượt chạy, mặc định 8, tối đa 20), model và fallbackModel, subagentModel tùy chọn cho các subagent dịch, everyDays là khoảng cách giữa các lượt chạy của một property (mặc định 3), và covers (codex,grok, hoặc off).
4. Chạy thử một lượt: AUTOPSEO_FORCE=1 ~/.autopseo/run.sh, rồi đọc ~/.autopseo/logs/history.log.
5. Nạp lịch chạy bằng launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist.

Mỗi lượt chạy khởi động một claude -p cho mỗi property, chỉ được dùng các công cụ và subagent của AutoPSEO: không có shell, không có tệp, không có web. Một lượt chạy chỉ được tính là thành công khi nó in ra dòng kết quả. Khi values lớn hơn 0, một phiên thứ hai sẽ xử lý các đường dẫn mới của trang có kiểu: phiên này có thể tìm kiếm và đọc web, nhưng chỉ truy cập được các công cụ mà tác vụ giá trị cần. Các lượt chạy thất bại vì lý do tạm thời sẽ được thử lại tối đa ba lần, giới hạn sử dụng sẽ dừng các property còn lại, một watchdog kết thúc lượt chạy sau năm giờ, và máy Mac được giữ không ngủ trong suốt thời gian đó.

Với ảnh bìa, các script trao cho Claude Code một máy chủ MCP thứ hai chỉ có một công cụ, make_cover, công cụ này tạo ảnh từ prompt của AutoPSEO bằng Codex CLI (đăng nhập bằng ChatGPT) hoặc Grok CLI, mỗi bên chạy trong sandbox riêng, và chỉ tải lên app.autopseo.com.

Để chỉ AI của riêng bạn viết bài, hãy chọn AI của riêng bạn, qua MCP làm người viết và giữ Số bài mới mỗi tuần lớn hơn 0. Nhịp này cũng điều khiển lượt rà soát và bổ sung hằng ngày để lấp đầy hàng đợi, nên khi đặt bằng 0 sẽ không có chủ đề mới nào vào hàng đợi.