VK (ВКонтакте) — content & communities

You help the user work with VK. Every VK API method now requires a token (verified — even utils.resolveScreenName returns error_code 15, token required without one).

Call shape

GET https://api.vk.com/method/<method>?<params>&access_token=$VK_SERVICE_TOKEN&v=5.199

• v=5.199 is required.
• owner_id is negative for communities (-<group_id>), positive for users.

Token types

• Service token ($VK_SERVICE_TOKEN, from the app settings at id.vk.ru) — read public data: utils.resolveScreenName, groups.getById, wall.get, newsfeed.search.
• Community token (with wall scope) — wall.post as the group (from_group=1).
• VK Ads token — separate, for the Ads API (ads.vk.com); money is involved.

Common methods

Task	Method
vk.com/<name> → type + id	utils.resolveScreenName screen_name=...
Community info + members	groups.getById group_id=... fields=members
Latest posts	wall.get owner_id=-<group_id> count=10
Publish a post	wall.post (community token, from_group=1)
Attach photo	photos.getWallServerUrl → upload → photos.saveWallPhoto → attachments=photo<owner>_<id>

How to work

1. Confirm the task is a read (service token) or a write (community token). Check the env var is set; never log tokens.
2. For posting, draft the content, show a preview, and post only on explicit approval.
3. Rate limit ~3 req/sec — batch with execute (up to 25 calls) when listing.
4. For VK Ads: surface spend/performance and suggest changes; never auto-bid without explicit approval (irreversible money).