# Wykop AI Agent Connect

> Read and analyze Wykop.pl — Poland's largest social news site and microblog: links, discussions, tag streams, search and user profiles, from your AI agent.

## Overview
- **Category:** news-media
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_UBYN2t8XT053eg8qGWcTIXGHaLAnEJdopFTzlgY8/ai-agent-connect
- **Tags:** wykop, poland, polish, social-news, link-aggregator, microblog, community, trending

## Description

Connect your AI agent to **Wykop.pl**, Poland's largest social news aggregator and microblog (think Reddit + Twitter for the Polish internet), through its official API v3.

### What you can do

- **Link Discovery** — Browse the main page (`list_links` type_="homepage") or the upcoming queue ("upcoming"), ranked by newest, active, commented or most dug.
- **Discussion Reading** — Pull the comments of any link with `list_link_comments`, ranked by best/newest/oldest.
- **Microblog** — Read trending entries with `list_entries` (hot entries in a 1-12h window) and inspect single posts with `get_entry`.
- **Tag Streams** — Explore everything posted under a tag (e.g. #programowanie, #polityka) with `get_tag_stream`, filterable by year and month.
- **Search** — Search links, entries and users with `search` — supports @user and #tag prefixes.
- **Profiles** — Check any user's public profile, activity summary and followers with `get_profile`.

### How it works

1. Register an application at **dev.wykop.pl** to get your Application Key and Secret
2. Subscribe to this server and paste both credentials
3. Ask your agent for Polish news, discussions and community content from Claude, Cursor, or any MCP-compatible client

### Who is this for?

- **Market Researchers** — Track what the Polish internet is discussing right now.
- **Journalists & Analysts** — Monitor breaking stories, tag communities and public sentiment in Poland.
- **Community & Brand Managers** — Follow mentions, tag activity and discussion trends on the largest Polish social platform.

## Tools

### get_link
Use it to inspect a specific link found via list_links or search. To read the discussion, feed the same id to list_link_comments. IDs are large integers.

Fetch a single Wykop link by ID with full details and vote stats

### list_link_comments
sort=best gives top-voted first, newest/oldest chronological. This is THE tool for reading link discussions. Paginate with page and limit (1-50).

Read the comment discussion of a Wykop link

### list_entries
sort=hot gives the trending entries (combine last_update to window: 1,2,3,6 or 12 hours), newest gives latest, active gives most-recently-commented. Entries have text content, optional photo/embed, author and vote counts. Paginate with page and limit (1-50, default 20).

Browse the Wykop microblog ("wpisy") — short posts with votes, like a Polish Twitter/mastodon stream

### get_entry
Use it to inspect a specific entry found via list_entries or search. IDs are large integers.

Fetch a single microblog entry by ID with its content and vote stats

### get_tag_stream
sort=all returns everything chronologically, best returns top-voted. Use for topic research: Polish communities organize heavily around tags like #programowanie, #polityka, #gamedev. Filter by year/month for historical research. Paginate with page and limit (1-50).

Browse all content under one Wykop tag (#hashtag) — entries and/or links

### search
type_ picks the result kind: links, entries, users or all. The query supports words plus prefixes: "@username" restricts to a user, "#tagname" to a tag. sort=score (relevance), popular, comments or newest. Results come back as link/entry/user objects — link and entry ids feed get_link/get_entry/list_link_comments. Search is Polish-content-first: try Polish phrasings for better recall. Paginate with page and limit (1-50, default 20).

Search Wykop links, entries and users by phrase — supports @user and #tag filters

### get_profile
Use it to check who is behind a link or entry, or to gauge how active/influential a user is. The username is the handle without the @ (e.g. "wykop").

Fetch a Wykop user public profile: bio, location, links/entries activity summary and followers

### list_links
type_="homepage" returns links already promoted to the main page; type_="upcoming" returns the Wykopalisko queue (new links awaiting promotion). sort: newest, active, commented or digged. Each item has title, source URL, author, vote counts (up/down) and comment count — feed the id to get_link for details or list_link_comments for the discussion. Paginate with page and limit (1-50, default 20).

Browse Wykop.pl links (news posts) — main page or upcoming queue, with votes and comment counts

## Prompt Examples

**Prompt:** 
```
What's trending on Wykop.pl main page right now?
```

**Response:** 
```
Fetching the main page with `list_links`... Top story: a Polish tech article about new EU regulations with 340 up votes and 89 comments. Want me to read the discussion?
```

**Prompt:** 
```
Search Wykop for recent posts about #programowanie (programming).
```

**Response:** 
```
Using `search` with query "#programowanie"... Found several recent entries: a thread about switching to Linux, a salary survey for Polish devs, and a link to a new Rust framework. Shall I pull the full comments of any of them?
```

**Prompt:** 
```
What are the hottest microblog entries on Wykop in the last 6 hours?
```

**Response:** 
```
Fetching `list_entries` with sort=hot, last_update=6... The hottest is a post from a Polish startup founder with 210 up votes, followed by a viral political discussion.
```

## Frequently Asked Questions

**Where do I get the Application Key and Secret?**
Register a new application at dev.wykop.pl (the official Wykop developer portal). Every Wykop API v3 request requires a JWT obtained with your application's key + secret — the server handles the login and token caching automatically.

**Can the agent post, vote or comment for me?**
No — this server is read-only. It exposes public content discovery and analysis with application-level credentials; writing actions (adding links, posting entries, voting) require a user-authenticated token and are intentionally not included.

**Is the content in Polish?**
Yes, Wykop content is overwhelmingly in Polish. The agent can still help you find and summarize discussions in English — use the search tool with Polish keywords or browse tag streams by topic for the best recall.
