# Plushcap

> Developer marketing intelligence for tracking engineering blogs, developer content, YouTube, Hacker News, and software development trends.

Use explicit `.md` suffixes or request `Accept: text/markdown` on documentation URLs.

## Start here

- [Docs](https://www.plushcap.com/docs.md)
- [HOWTOs](https://www.plushcap.com/docs/how-to.md)
- [Competitive analysis](https://www.plushcap.com/docs/competitive.md)
- [X API](https://www.plushcap.com/docs/x.md)
- [LinkedIn API](https://www.plushcap.com/docs/linkedin.md)
- [MCP server docs](https://www.plushcap.com/docs/mcp.md)
- [API authentication](https://www.plushcap.com/docs/authentication.md)
- [Companies API](https://www.plushcap.com/docs/companies.md)
- [Blog posts API](https://www.plushcap.com/docs/blog-posts.md)
- [Trends API](https://www.plushcap.com/docs/trends.md)
- [YouTube API](https://www.plushcap.com/docs/youtube.md)
- [Hacker News API](https://www.plushcap.com/docs/hacker-news.md)

## Machine-readable resources

- [Sitemap](https://www.plushcap.com/sitemap.xml)
- [AI Catalog](https://www.plushcap.com/.well-known/ai-catalog.json)
- [API Catalog](https://www.plushcap.com/.well-known/api-catalog)
- [Public REST OpenAPI description](https://www.plushcap.com/api/v1/openapi.json)
- [Agent Skills index](https://www.plushcap.com/.well-known/agent-skills/index.json)
- [MCP server](https://mcp.plushcap.com/mcp)
- [MCP server card](https://mcp.plushcap.com/.well-known/mcp/server-card.json)
- [MCP OAuth protected-resource metadata](https://mcp.plushcap.com/.well-known/oauth-protected-resource/mcp)
- [Companies JSON API](https://www.plushcap.com/api/v1/companies/)
- [Trend topics JSON API](https://www.plushcap.com/api/v1/trends/topics/)

## Agent notes

- Use `list_companies` or `/api/v1/companies/` to discover valid company slugs before querying company-specific data.
- Public discovery endpoints are anonymous. Detailed blog, YouTube, Hacker News, and trend endpoints may require an API key or MCP authorization.
- Prefer Markdown docs endpoints such as `/docs/mcp.md` when reading documentation.