PubShip

PubShip

Quy trình phát triển Google Play, ngay trên máy tính của bạn. Kiểm tra các bản phát hành, hiểu đánh giá và báo cáo, đồng thời chuẩn bị các thay đổi được ủy quyền rõ ràng từ MCP client của bạn.

Bắt đầu cục bộ

Sử dụng tài khoản dịch vụ của riêng bạn với quyền truy cập cho các ứng dụng của bạn trong Play Console. Giữ tệp JSON riêng tư của bạn bên ngoài kho lưu trữ này. Chỉ cấp các quyền cần thiết cho các thao tác bạn dự định thực hiện. Không bao giờ dán thông tin xác thực vào cuộc trò chuyện với trợ lý.

export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship

Thao tác này khởi động máy chủ stdio, máy chủ này sẽ chờ MCP client. Để kiểm tra cài đặt mà không cần thông tin xác thực:

uvx pubship --check

Phiên bản 0.24.0 là ứng viên phát hành đầu tiên của PubShip. Việc xuất bản lên PyPI và MCP Registry là các bước riêng biệt và không được ngụ ý bởi bản checkout này. Cho đến khi được xuất bản, hãy sử dụng uv run pubship --check từ bản checkout nguồn sau uv sync.

Kết nối trợ lý

Claude Code

claude mcp add --transport stdio pubship -- uvx pubship

Đặt các biến môi trường ở trên trong shell khởi chạy client của bạn. Khởi động lại client sau khi thay đổi môi trường của nó.

Codex

codex mcp add pubship -- uvx pubship

Khung MCP chung

Cấu hình máy chủ stdio với tệp thực thi uvx, đối số pubship và môi trường cục bộ của bạn. Đối với các client yêu cầu cấu hình rõ ràng:

{
  "mcpServers": {
    "pubship": {
      "command": "uvx",
      "args": ["pubship"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
        "GOOGLE_PLAY_PACKAGES": "com.example.app"
      }
    }
  }
}

Cấu hình client vẫn nằm trên máy tính của bạn. Tham khảo thiết lập để biết các chế độ xác thực thay thế, API đã bật, báo cáo và ranh giới quyền.

Nó có thể làm gì?

Kho lưu trữ cố định chứa 172 định nghĩa phương thức. 170 phương thức có triển khai, một phương thức lưu trữ đăng ký không được Google hỗ trợ và quyền truy cập giao dịch mua bị hủy bị vô hiệu hóa có chủ đích theo chính sách dự án. Các thao tác bị vô hiệu hóa không thể được gọi thông qua các công cụ cục bộ hoặc tự lưu trữ.

• Đọc bản phát hành, đánh giá, chỉ số Android và báo cáo hàng loạt có phạm vi.
• Kiểm tra tài nguyên danh mục, đăng ký, sản phẩm và tài khoản với các cấp quyền dữ liệu nhạy cảm riêng biệt.
• Chuẩn bị và xem xét các thao tác ghi với quyền ứng dụng/phương thức rõ ràng và thực thi một lần.
• Giữ các chuyển tệp cục bộ có giới hạn và tách biệt xuất bản khỏi giai đoạn chỉnh sửa.

Đọc là mặc định. Ghi tùy chọn và đọc dữ liệu nhạy cảm yêu cầu cấu hình rõ ràng. Văn bản từ nhà cung cấp là dữ liệu không đáng tin cậy. Dữ liệu thiếu không phải là số không; một thay đổi đã gửi không nhất thiết được xuất bản. Không có số lượng thao tác nào là tuyên bố xác minh trực tiếp của Google.

Khám phá các hợp đồng và ranh giới

• Danh mục phương thức đầy đủ
• Các bài kiểm tra tổng hợp liên quan
• Vòng đời chỉnh sửa
• Thao tác mua hàng
• Chuyển tệp
• Cấu hình tự lưu trữ

Tự lưu trữ cho tài khoản của riêng bạn

pubship-server giữ lại triển khai HTTP cho cơ sở hạ tầng bạn kiểm soát. Nó từ chối khởi động nếu không có PUBSHIP_SERVER_ALLOWED_EMAILS. Đăng nhập yêu cầu mã thông báo Google ID đã ký, khớp chính xác email đã xác minh và ràng buộc nonce trước khi bất kỳ thông tin xác thực Google nào được lưu trữ. Xóa tài khoản khỏi danh sách cho phép sẽ vô hiệu hóa các cấp quyền đã lưu của tài khoản đó khi sử dụng tiếp theo. Các cấp quyền cũ không có danh tính đã xác minh phải kết nối lại. Đăng ký vẫn đóng cho đến khi người vận hành bật rõ ràng.

Không có dịch vụ kết nối Google nào do dự án vận hành. Xem quyết định ưu tiên cục bộ và thiết lập tự lưu trữ.

Phát triển

env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --all-extras --group browser
env -u GOOGLE_APPLICATION_CREDENTIALS uv run pytest
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff format --check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_catalog.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_verification.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/distribution_metadata.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv build
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/check_artifacts.py

Các bài kiểm tra sử dụng nhà cung cấp giả. Các bài kiểm tra trình duyệt yêu cầu công cụ Playwright đã cài đặt; các bài kiểm tra tích hợp sao lưu yêu cầu age. Ghi lại trung thực các kiểm tra nền tảng không khả dụng. Xem chính sách đóng góp, quy trình phát hành và báo cáo bảo mật.

Mục đích sử dụng

PubShip giúp các nhà phát triển tự động hóa công việc phân phối Google Play của riêng họ. Nó chạy trên máy tính của bạn hoặc trên cơ sở hạ tầng bạn kiểm soát, với thông tin xác thực Google và quyền Play Console của riêng bạn. Dự án PubShip không vận hành dịch vụ lưu trữ và không bao giờ nhận thông tin xác thực của bạn. Chỉ sử dụng nó cho các ứng dụng và tài khoản nhà phát triển mà bạn hoặc tổ chức của bạn sở hữu, đồng thời tuân thủ Điều khoản API Play Developer của Google. Các phiên bản PubShip được lưu trữ bởi người khác không được cung cấp hoặc xác nhận bởi dự án PubShip.

PubShip là một dự án mã nguồn mở độc lập và không liên kết với, được xác nhận bởi, hoặc được tài trợ bởi Google. Google, Google Play và Android là nhãn hiệu của Google LLC.

Giấy phép

PubShip là phần mềm tự do theo Giấy phép Công cộng GNU Affero v3.0 chỉ (AGPL-3.0-only). Bản quyền (C) 2026 Denys Vorobyov. Đối với các điều khoản giấy phép khác, hãy liên hệ legal@pubship.dev.

Nhãn hiệu · Thông báo bên thứ ba · Trang web