HeroSEO MCP — GA4 + Search Console cho Claude

MCP Server giúp Claude (Claude Desktop) đọc dữ liệu từ Google Analytics 4 và Google Search Console bằng tài khoản Google của bạn — hỏi bằng tiếng tự nhiên, Claude tự gọi API.

Read-only · token lưu cục bộ trên máy bạn · không cần tự tạo Google Cloud project.

mcp-name: vn.dichvuseotongthe/heroseo-mcp

Cài đặt nhanh

uv tool install heroseo-mcp

Thêm vào file cấu hình Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "heroseo-mcp": {
      "command": "uvx",
      "args": ["heroseo-mcp"]
    }
  }
}

Khởi động lại Claude Desktop → hỏi "Liệt kê các GA4 property của tôi." → lần đầu Claude sẽ mở trình duyệt cho bạn đăng nhập Google (cấp quyền Analytics + Search Console, read-only). Xong là dùng được.

👉 Hướng dẫn chi tiết từng bước: HOW_TO_USE.md.

Tools

Google Analytics 4

Tool	Mô tả
`ga4_list_accounts`	Liệt kê tất cả GA4 accounts
`ga4_list_properties`	Liệt kê GA4 properties (websites/apps)
`ga4_run_report`	Report tuỳ chỉnh — dimensions, metrics, date range, sort
`ga4_run_realtime_report`	Users đang active trong 30 phút gần nhất
`ga4_get_metadata`	Dimensions/metrics khả dụng cho 1 property

Google Search Console

Tool	Mô tả
`gsc_list_sites`	Liệt kê tất cả GSC properties
`gsc_query_search_analytics`	Top queries / pages / countries / devices — clicks, impressions, CTR, position
`gsc_inspect_url`	Inspect 1 URL — index status, crawl, sitemap, rich results
`gsc_list_sitemaps`	Liệt kê sitemaps đã submit
`gsc_get_sitemap`	Chi tiết 1 sitemap — errors, warnings, last download

Ví dụ prompt

"Property 123456789: 10 trang được xem nhiều nhất 28 ngày qua."

"Site https://example.com/ : top 20 query nhiều impression nhất tháng vừa rồi."

"Trang nào của tôi đang rank cho từ khoá 'dịch vụ seo'?"

"URL https://example.com/blog/abc đã được Google index chưa?"

"So sánh sessions từ organic search tuần này với tuần trước cho property 123456789."

Quyền & bảo mật

Scope OAuth (read-only): analytics.readonly + webmasters.readonly — không sửa/xoá được dữ liệu.
Token lưu cục bộ tại ~/.heroseo-mcp/token.json, không gửi về nhà phát hành.
Thu hồi quyền bất cứ lúc nào tại myaccount.google.com/permissions.
Chính sách bảo mật · liên hệ: teamheroseo@gmail.com

License

MIT

Development Status
- 4 - Beta
Intended Audience
- Developers
Programming Language
- Python :: 3
Topic
- Internet :: WWW/HTTP :: Indexing/Search

Metadata

Development Status
- 4 - Beta
Intended Audience
- Developers
Programming Language
- Python :: 3
Topic
- Internet :: WWW/HTTP :: Indexing/Search

Release files for heroseo-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for heroseo-mcp 0.1.0
File	Size	Uploaded	Provenance
heroseo_mcp-0.1.0.tar.gz	16.1 kB	Jun 1, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for heroseo-mcp 0.1.0
File	Interpreter	ABI	Platform	Reset
heroseo_mcp-0.1.0-py3-none-any.whl 20.3 kB Jun 1, 2026 Without provenance	Python 3	none	any	Details

Total release size: 36.4 kB

Release files / heroseo_mcp-0.1.0.tar.gz

Download URL	heroseo_mcp-0.1.0.tar.gz
Size	16.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`7383b1d28fbc0c83424337b494730636340f9446600842b31686fb6b7d3a2115`
BLAKE2b-256 checksum How to use checksums	`a3650fb420e2cc0c21d3fb9c2e394d898a5ada332a3d75c448dd9bd293ede05d`
Upload date	Jun 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / heroseo_mcp-0.1.0-py3-none-any.whl

Download URL	heroseo_mcp-0.1.0-py3-none-any.whl
Size	20.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`34bca04c691ce42ebd0d4fe05fc64b991c643b00245d997b845cdb3b02a2dfdb`
BLAKE2b-256 checksum How to use checksums	`c9a706a64024c5a4fa31237dbfa936b6703d094ce519611dcc8dd5ef9dd8ebad`
Upload date	Jun 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Security for heroseo-mcp 0.1.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

Jun 1, 2026 2 release files No provenance

heroseo-mcp 0.1.0