PubShip

ทางการ

เซิร์ฟเวอร์ MCP แบบโอเพนซอร์สสำหรับขั้นตอนการทำงานของนักพัฒนา Google Play ทำงานในเครื่องของคุณเองด้วยข้อมูลประจำตัวของคุณ

GitHubลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย PubShip MCP?

ตรวจสอบการเผยแพร่และรีวิวบน Play — ขอให้ผู้ช่วยของคุณดึงข้อมูลการเผยแพร่ล่าสุด รีวิวจากผู้ใช้ และข้อมูลสำคัญของ Android สำหรับแอปของคุณ
ตรวจสอบรายงานสรุปตามขอบเขต — ให้ผู้ช่วยของคุณดึงข้อมูลและสรุปรายงานแบบกลุ่มที่ครอบคลุมข้อมูลแคตตาล็อก การสมัครสมาชิก ผลิตภัณฑ์ และบัญชี
เตรียมและจัดเตรียมการแก้ไข — ขอให้ผู้ช่วยของคุณร่างและตรวจสอบการเปลี่ยนแปลงแอปพร้อมการตรวจสอบสิทธิ์อย่างชัดเจน โดยแยกการแก้ไขออกจากการเผยแพร่
จัดการการถ่ายโอนไฟล์ในเครื่อง — สั่งให้ผู้ช่วยของคุณจัดการการถ่ายโอนไฟล์ที่มีขอบเขตจำกัดระหว่างเครื่องของคุณและ Play Console โดยไม่ผสมการจัดเตรียมกับการอัปเดตแบบสด

เอกสาร

PubShip

เวิร์กโฟลว์สำหรับนักพัฒนา Google Play จากคอมพิวเตอร์ของคุณเอง ตรวจสอบรีลีส ทำความเข้าใจรีวิวและรายงาน และเตรียมการเปลี่ยนแปลงที่ได้รับอนุญาตอย่างชัดเจนจาก MCP client ของคุณ

เริ่มต้นใช้งานในเครื่อง

ใช้ service account ของคุณเองที่มีสิทธิ์สำหรับแอปของคุณใน Play Console เก็บไฟล์ private JSON ไว้นอก repository นี้ ให้สิทธิ์เฉพาะที่จำเป็นสำหรับการดำเนินการที่คุณต้องการเท่านั้น ห้ามวางข้อมูลประจำตัวลงในการสนทนากับผู้ช่วย

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

คำสั่งนี้จะเริ่มเซิร์ฟเวอร์ stdio ซึ่งรอรับ MCP client สำหรับการตรวจสอบการติดตั้งโดยไม่ต้องใช้ข้อมูลประจำตัว:

uvx pubship --check

เวอร์ชัน 0.24.0 เป็น PubShip release candidate ตัวแรก การเผยแพร่บน PyPI และ MCP Registry เป็นขั้นตอนแยกต่างหาก และไม่ได้หมายความรวมถึงการ checkout นี้ จนกว่าจะเผยแพร่ ให้ใช้ uv run pubship --check จาก source checkout หลังจาก uv sync

เชื่อมต่อผู้ช่วย

Claude Code

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

ตั้งค่าตัวแปรสภาพแวดล้อมด้านบนในเชลล์ที่ใช้เปิด client ของคุณ รีสตาร์ท client หลังจากเปลี่ยนสภาพแวดล้อม

Codex

codex mcp add pubship -- uvx pubship

MCP harness ทั่วไป

กำหนดค่าเซิร์ฟเวอร์ stdio ด้วย executable uvx, argument pubship และสภาพแวดล้อมในเครื่องของคุณ สำหรับ client ที่ต้องมีการกำหนดค่าอย่างชัดเจน:

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

การกำหนดค่า client ยังคงอยู่บนคอมพิวเตอร์ของคุณ ดู การตั้งค่า สำหรับวิธีการยืนยันตัวตนแบบอื่น, API ที่เปิดใช้งาน, รายงาน และขอบเขตสิทธิ์

ทำอะไรได้บ้าง?

Local API coverage

รายการที่ตรึงไว้มีคำจำกัดความของเมธอด 172 รายการ 170 รายการมีการนำไปใช้งาน หนึ่งเมธอดสำหรับการเก็บถาวรการสมัครสมาชิกไม่ได้รับการสนับสนุนโดย Google และการเข้าถึง voided-purchases ถูกปิดใช้งานโดยนโยบายของโครงการ การดำเนินการที่ถูกปิดใช้งานไม่สามารถเรียกใช้ผ่านเครื่องมือในเครื่องหรือ self-host ได้

อ่านรีลีส รีวิว Android vitals และรายงานจำนวนมากตามขอบเขตที่กำหนด
ตรวจสอบทรัพยากรแคตตาล็อก การสมัครสมาชิก ผลิตภัณฑ์ และบัญชี พร้อมการให้สิทธิ์ข้อมูลที่ละเอียดอ่อนแยกต่างหาก
เตรียมและตรวจสอบการเขียนด้วยสิทธิ์แอป/เมธอดที่ชัดเจนและการดำเนินการแบบใช้ครั้งเดียว
จำกัดการถ่ายโอนไฟล์ในเครื่องและแยกการเผยแพร่ออกจากขั้นตอนการแก้ไข

การอ่านเป็นค่าเริ่มต้น การเขียนเพิ่มเติมและการอ่านข้อมูลที่ละเอียดอ่อนต้องมีการกำหนดค่าอย่างชัดเจน ข้อความจากผู้ให้บริการเป็นข้อมูลที่ไม่น่าเชื่อถือ ข้อมูลที่ขาดหายไปไม่ได้หมายความว่าเป็นศูนย์ การเปลี่ยนแปลงที่ส่งไปไม่จำเป็นต้องเผยแพร่ จำนวนการดำเนินการไม่ใช่การอ้างว่ามีการตรวจสอบโดย Google แบบสด

สำรวจสัญญาและขอบเขต

การโฮสต์ด้วยตนเองสำหรับบัญชีของคุณเอง

pubship-server ยังคงการใช้งาน HTTP สำหรับโครงสร้างพื้นฐานที่คุณควบคุม ปฏิเสธการเริ่มต้นโดยไม่มี PUBSHIP_SERVER_ALLOWED_EMAILS การลงชื่อเข้าต้องใช้ Google ID token ที่ลงนามแล้ว อีเมลที่ตรงกันแบบตรวจสอบแล้ว และการผูก nonce ก่อนที่จะบันทึกข้อมูลประจำตัวของ Google ใด ๆ การลบบัญชีออกจาก allowlist จะทำให้สิทธิ์ที่เก็บไว้ไม่ถูกต้องในการใช้งานครั้งถัดไป สิทธิ์เดิมที่ไม่มีการยืนยันตัวตนต้องเชื่อมต่อใหม่ การลงทะเบียนยังคงปิดอยู่จนกว่าผู้ดำเนินการจะเปิดใช้งานอย่างชัดเจน

ไม่มีบริการที่เชื่อมต่อกับ Google ที่ดำเนินการโดยโครงการ ดู การตัดสินใจแบบ local-first และ การตั้งค่า self-host

การพัฒนา

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

การทดสอบใช้ผู้ให้บริการจำลอง การทดสอบเบราว์เซอร์ต้องติดตั้ง Playwright engines การทดสอบการรวมแบ็กอัปต้องใช้ age บันทึกการตรวจสอบแพลตฟอร์มที่ไม่พร้อมใช้งานอย่างตรงไปตรงมา ดู นโยบายการมีส่วนร่วม, กระบวนการเผยแพร่ และ การรายงานความปลอดภัย

การใช้งานตามวัตถุประสงค์

PubShip ช่วยนักพัฒนาอัตโนมัติงานการเผยแพร่ Google Play ของตนเอง ทำงานบนคอมพิวเตอร์ของคุณหรือโครงสร้างพื้นฐานที่คุณควบคุม ด้วยข้อมูลประจำตัวของ Google และสิทธิ์ Play Console ของคุณเอง โครงการ PubShip ไม่ได้ให้บริการโฮสต์และไม่เคยรับข้อมูลประจำตัวของคุณ ใช้เฉพาะกับแอปและบัญชีนักพัฒนาที่คุณหรือองค์กรของคุณเป็นเจ้าของ และปฏิบัติตามข้อกำหนดของ Google Play Developer API บริการ PubShip ที่โฮสต์โดยผู้อื่นไม่ได้จัดให้หรือรับรองโดยโครงการ PubShip

PubShip เป็นโครงการโอเพนซอร์สอิสระและไม่เกี่ยวข้องกับ รับรองโดย หรือสนับสนุนโดย Google Google, Google Play และ Android เป็นเครื่องหมายการค้าของ Google LLC

สัญญาอนุญาต

เครื่องหมายการค้า · ประกาศบุคคลที่สาม · เว็บไซต์