Social Fetch
REMOTE · API.SOCIALFETCH.DEV · SCANNED AUG 3
Public social-data API and live docs for AI coding agents.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 186 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability71
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 15085 tokens (~81/item across 186 items; 186 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage98
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 93% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · api.socialfetch.dev
claude mcp add --transport http social-freak-ltd-socialfetch https://api.socialfetch.dev/mcp
[mcp_servers.social-freak-ltd-socialfetch] url = "https://api.socialfetch.dev/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"social-freak-ltd-socialfetch": {
"type": "remote",
"url": "https://api.socialfetch.dev/mcp",
"enabled": true
}
}
} openclaw mcp add social-freak-ltd-socialfetch --url https://api.socialfetch.dev/mcp --transport streamable-http
mcp_servers:
social-freak-ltd-socialfetch:
url: "https://api.socialfetch.dev/mcp" {
"mcpServers": {
"social-freak-ltd-socialfetch": {
"type": "http",
"url": "https://api.socialfetch.dev/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +1
- Server version: 0.23.0 → 0.24.0 functional
- New tool “instagram_post_comments_replies_list” functional
- 31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 −1
- Schema quality: excellent → good functional
- Server version: 0.20.0 → 0.21.0 functional
- New tool “soundcloud_profile_get” functional
- New tool “soundcloud_profile_tracks_list” functional
- New tool “soundcloud_track_get” functional
- “facebook_profile_posts_list” reworded the description of “cursor” cosmetic
- “facebook_profile_reels_list” reworded the description of “cursor” cosmetic
- “google_company_ads_list” reworded the description of “cursor” cosmetic
- “hackernews_search_list” reworded the description of “pageSize” cosmetic
- “instagram_profile_posts_list” reworded the description of “cursor” cosmetic
- “instagram_profile_reels_list” reworded the description of “cursor” cosmetic
- “linkedin_jobs_search_list” reworded the description of “country” cosmetic
- “linkedin_jobs_search_list” reworded the description of “location” cosmetic
- “linkedin_profiles_posts_list” reworded the description of “endDate” cosmetic
- “linkedin_profiles_posts_list” reworded the description of “startDate” cosmetic
- “reddit_subreddit_posts_list” reworded the description of “cursor” cosmetic
- “linkedin_jobs_search_list” reworded the description of “keyword” cosmetic
- “facebook_company_ads_list” reworded the description of “cursor” cosmetic
- “facebook_group_posts_list” reworded the description of “cursor” cosmetic
- “facebook_profile_photos_list” reworded the description of “cursor” cosmetic
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 66
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://api.socialfetch.dev/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=api.socialfetch.dev | CN=YR2,O=Let's Encrypt,C=US | 12 Jun 2026 | 10 Sept 2026 | RSA 2048 | SHA256-RSA | 5b3c82fad2f96dbcea9afc120e743f809ce |
| SANs: api.socialfetch.dev | ||||||
| CN=YR2,O=Let's Encrypt,C=US (CA) | CN=Root YR,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | RSA 2048 | SHA256-RSA | 4ebd24947e24d394802d84a52fd5b319 |
| CN=Root YR,O=ISRG,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | RSA 4096 | SHA256-RSA | f24b6d17f9d9ad7cb1c9fea78782699f |
DNSSEC secure
Validation of api.socialfetch.dev. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| dev. | present | 60074 | 8 | Verified |
| socialfetch.dev. | present | 35691 | 13 | Verified |
| api.socialfetch.dev. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000 |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.socialfetch.dev/mcp | Verified | 200 | |
| http (plaintext) | http://api.socialfetch.dev/mcp | HTTPS enforced | 308 | https://api.socialfetch.dev/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
auth_whoami Whoami ~19
Get the authenticated API account for this session.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
billing_balance_get Get account balance ~22
Get remaining credit balance before running large batches of metered tools.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
bluesky_post_get Get Bluesky post ~32
Get a single Bluesky post by URL.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Link to the Bluesky post. |
No output schema declared.
No examples provided.
bluesky_profile_get Get Bluesky profile ~46
Get a Bluesky profile for a creator or account. Accepts a handle.
| Name | Type | Req | Description |
|---|---|---|---|
| handle | string | yes | Bluesky handle to look up, with or without a leading @. |
No output schema declared.
No examples provided.
bluesky_profile_posts_list List Bluesky profile posts ~78
List posts from a Bluesky profile by handle. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Pagination cursor returned by a previous response. |
| handle | string | yes | Bluesky handle whose posts should be listed. |
| userId | string | — | Optional Bluesky user id to speed up the request. |
No output schema declared.
No examples provided.
docs_read Read SocialFetch docs page ~133
Read a corpus page by docsPathname from docs_search. Defaults to mode=outline (compact field digest). Pass mode=full for Examples/SDK snippets. Accepts /docs/... and /product/... pathnames (including /product/ask-ai/field-crosswalk).
| Name | Type | Req | Description |
|---|---|---|---|
| docsPathname | string | yes | Corpus pathname from docs_search, e.g. /docs/api/v1/tiktok/videos/get or /product/ask-ai/field-crosswalk. Trailing .mdx accepted. |
| mode | string | — | outline (default) = compact params/credits/field digest. full = complete page including Examples. |
No output schema declared.
No examples provided.
docs_search Search SocialFetch docs ~127
Search SocialFetch docs for API/SDK questions. For response fields use docs_read (defaults to outline). For cross-platform author/timestamp naming, search `field crosswalk` or read /product/ask-ai/field-crosswalk.
| Name | Type | Req | Description |
|---|---|---|---|
| currentDocsPathname | string | — | Optional current SocialFetch docs pathname, such as /docs/sdk or /product/guides/..., to boost nearby results. |
| limit | integer | — | Maximum number of docs results to return. |
| query | string | yes | Natural-language description of what to find in SocialFetch docs (at least 2 characters). |
No output schema declared.
No examples provided.
facebook_adLibrary_ad_get Get Facebook Ad Library ad ~92
Get a single Facebook Ad Library ad by archive id or public Ad Library URL.
| Name | Type | Req | Description |
|---|---|---|---|
| adId | string | — | Facebook Ad Library archive id for the ad. |
| includeTranscript | — | — | When true, includes a plain-text transcript when available for the ad video. |
| trim | — | — | When true, requests a smaller payload before normalization. |
| url | string | — | Public Facebook Ad Library URL for the ad. |
No output schema declared.
No examples provided.
facebook_adLibrary_ads_search_get Search Facebook Ad Library ads ~202
Search Facebook Ad Library ads by keyword and filters. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| adType | string | — | Optional filter for all ads or political and issue ads. |
| country | string | — | Optional country code filter. Use ALL to search all countries. |
| cursor | string | — | Opaque pagination cursor from a previous response. |
| endDate | string | — | Optional end date filter in YYYY-MM-DD format. |
| mediaType | string | — | Optional creative media filter. |
| query | string | yes | Search query text for Facebook Ad Library ads. |
| searchType | string | — | Optional keyword matching mode for the search query. |
| sortBy | string | — | Optional sort order for returned ads. |
| startDate | string | — | Optional start date filter in YYYY-MM-DD format. |
| status | string | — | Optional ad status filter. |
| trim | boolean | — | When true, returns a smaller response with fewer fields. |
No output schema declared.
No examples provided.
facebook_adLibrary_companies_search Search Facebook ad library companies ~53
Search Facebook Ad Library companies / advertisers by name. Accepts a company name. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Search query text for Facebook ad library companies. |
No output schema declared.
No examples provided.
facebook_company_ads_list List Facebook company ads ~200
List ads a company or Page is running in the Facebook Ad Library. Accepts a page id or company name. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| companyName | string | — | Company or page name to search when you do not have a page id. |
| country | string | — | Optional country code filter. Use ALL to search all countries. |
| cursor | string | — | Opaque pagination cursor from a previous response. |
| endDate | string | — | Optional end date filter in YYYY-MM-DD format. |
| language | string | — | Optional language code filter. |
| mediaType | string | — | Optional creative media filter. |
| pageId | string | — | Facebook page id when you have it instead of a company name. |
| sortBy | string | — | Optional sort order for returned ads. |
| startDate | string | — | Optional start date filter in YYYY-MM-DD format. |
| status | string | — | Optional ad status filter. |
No output schema declared.
No examples provided.
facebook_group_posts_list List Facebook group posts ~144
List posts from a Facebook group by group URL. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque pagination cursor from a previous response. |
| sortBy | string | — | Optional sort order for posts returned from the group feed. `top`: Facebook's default relevance ranking. `recentActivity`: sorted by most recent comment/reaction activity. `chronological`: regular po… |
| url | string | yes | Public Facebook group URL whose posts should be listed. |
No output schema declared.
No examples provided.
facebook_marketplace_item_get Get Facebook Marketplace item ~59
Get details for a Facebook Marketplace listing by item URL.
| Name | Type | Req | Description |
|---|---|---|---|
| itemId | string | — | Facebook Marketplace item identifier. Provide this instead of url when you already know the item id. |
| url | string | — | Public Facebook Marketplace item URL. |
No output schema declared.
No examples provided.
facebook_marketplace_locations_search Search Facebook Marketplace locations ~57
Search Facebook Marketplace locations to obtain coordinates for listing search. Accepts a city or place name. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | City or place name to search for Facebook Marketplace locations. |
No output schema declared.
No examples provided.
facebook_marketplace_search_list Search Facebook Marketplace listings ~379
Search Facebook Marketplace listings by keyword near a latitude and longitude. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| availability | string | — | Optional availability filter for marketplace listings. |
| condition | string | — | Optional item condition filter for marketplace listings. |
| count | integer | — | Optional number of listings to return. |
| cursor | string | — | Opaque pagination cursor returned by a previous response. |
| dateListed | string | — | Optional date-listed filter for marketplace listings. `1`/`last24Hours` both mean the last 24 hours, `7`/`last7Days` both mean the last 7 days, and `30`/`last30Days` both mean the last 30 days — thes… |
| deliveryMethod | string | — | Optional delivery method filter for marketplace listings. |
| lat | number | — | Latitude for the marketplace search location. |
| lng | number | — | Longitude for the marketplace search location. |
| maxPrice | number | — | Optional maximum listing price. Must be greater than or equal to `minPrice` when both are set. |
| minPrice | number | — | Optional minimum listing price. Must be less than or equal to `maxPrice` when both are set. |
| query | string | yes | Search query text for marketplace listings. |
| radiusKm | number | — | Optional search radius in kilometers. |
| sortBy | string | — | Optional sort order for marketplace listings. `suggested`: Facebook's default relevance ranking. `distanceAscend`: nearest first. `creationTimeDescend`: newest listings first. `priceAscend`/`priceDes… |
No output schema declared.
No examples provided.
facebook_post_comments_list List Facebook post or reel comments ~93
List comments on a Facebook post or Reel by URL. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque cursor from a previous response to fetch the next page. |
| feedbackId | string | — | Optional Facebook feedback identifier for the target post; when available it can improve lookup performance. |
| url | string | — | Link to the Facebook post or reel whose comments should be listed. |
No output schema declared.
No examples provided.
facebook_post_comments_replies_list List Facebook comment replies ~62
List replies to a Facebook comment. Accepts a from post comments. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | yes | Comment `repliesCursor` from post comments, or `page.nextCursor` to paginate replies. |
No output schema declared.
No examples provided.
facebook_post_get Get Facebook post or reel ~70
Get a Facebook post or Reel by URL.
| Name | Type | Req | Description |
|---|---|---|---|
| includeComments | — | — | When true, includes a sample of top-level comments when available. |
| includeTranscript | — | — | When true, includes a plain-text transcript when available for the video. |
| url | string | yes | Public permalink to the Facebook post or reel. |
No output schema declared.
No examples provided.
facebook_post_transcript_get Get Facebook post transcript ~42
Get the transcript for a Facebook post or Reel by URL.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Link to the Facebook post or reel whose transcript should be returned. |
No output schema declared.
No examples provided.
facebook_profile_get Get Facebook profile ~56
Get a Facebook profile or Page by URL or username.
| Name | Type | Req | Description |
|---|---|---|---|
| includeBusinessHours | boolean | — | Optional: include structured business hours in the response when available. |
| url | string | yes | Facebook public profile or page URL to look up. |
No output schema declared.
No examples provided.
facebook_profile_photos_list List Facebook profile photos ~71
List photos from a Facebook profile or Page. Accepts a profile or page URL. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque pagination cursor from a previous response. |
| url | string | yes | Public Facebook profile or page URL whose photos should be listed. |
No output schema declared.
No examples provided.
facebook_profile_posts_list List Facebook profile posts ~89
List posts from a Facebook profile or Page. Accepts a profile URL or page id. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque pagination cursor from a previous response. |
| pageId | string | — | Facebook page or profile id when you have it instead of a full URL. |
| url | string | — | Full public Facebook profile or page URL. |
No output schema declared.
No examples provided.
facebook_profile_reels_list List Facebook profile reels ~72
List Reels from a Facebook profile or Page. Accepts a profile or page URL. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque pagination cursor from a previous response. |
| url | string | yes | Public Facebook profile or page URL whose reels should be listed. |
No output schema declared.
No examples provided.
github_profile_activity_list List GitHub profile activity ~106
List recent public activity for a GitHub profile, one month per request. Accepts a username. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Pagination cursor from a previous response (`data.page.nextCursor`). Pages backward one month at a time through the selected year. |
| handle | string | yes | GitHub username whose public activity timeline should be listed. |
| year | integer | — | Calendar year to read activity for. Default: current calendar year. |
No output schema declared.
No examples provided.
github_profile_contributions_get Get GitHub contribution graph ~69
Get the contribution graph for a GitHub profile for a given year. Accepts a username.
| Name | Type | Req | Description |
|---|---|---|---|
| handle | string | yes | GitHub username to look up, with or without a leading @. |
| year | integer | — | Calendar year for the contribution graph. Default: current calendar year. |
No output schema declared.
No examples provided.
github_profile_followers_list List GitHub profile followers ~69
List followers for a GitHub profile. Accepts a username. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Pagination cursor from a previous response (numeric page index as a string). |
| handle | string | yes | GitHub username whose followers should be listed. |
No output schema declared.
No examples provided.
github_profile_following_list List GitHub profile following ~70
List accounts a GitHub profile follows. Accepts a username. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Pagination cursor from a previous response (numeric page index as a string). |
| handle | string | yes | GitHub username whose following list should be listed. |
No output schema declared.
No examples provided.
github_profile_get Get GitHub profile ~45
Get a GitHub profile for a user or organization. Accepts a username.
| Name | Type | Req | Description |
|---|---|---|---|
| handle | string | yes | GitHub username to look up, with or without a leading @. |
No output schema declared.
No examples provided.
github_profile_repositories_list List GitHub profile repositories ~143
List repositories for a GitHub user or organization. Accepts a username. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Pagination cursor returned by a previous response. |
| direction | string | — | Sort direction. |
| handle | string | yes | GitHub username whose public repositories should be listed. |
| sort | string | — | Sort field for repositories. |
| type | string | — | Repository type filter. `owner`: repos owned by the user. `all`: owned repos plus repos from organizations the user belongs to. `member`: only repos the user belongs to via organization membership (n… |
No output schema declared.
No examples provided.
github_repositories_get Get GitHub repository ~32
Get a single GitHub repository by URL.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Full public GitHub repository URL. |
No output schema declared.
No examples provided.
github_trending_developers_list List trending GitHub developers ~62
List trending GitHub developers for a language and time window. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | — | Optional trending coding language filter. |
| since | string | — | Trending time window. Default: `daily`. |
No output schema declared.
No examples provided.
github_trending_repositories_list List trending GitHub repositories ~74
List trending GitHub repositories for a language and time window. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | — | Optional coding language filter. |
| since | string | — | Trending time window. Default: `daily`. |
| spokenLanguageCode | string | — | Optional spoken language code filter. |
No output schema declared.
No examples provided.
google_adLibrary_ad_get Get Google Ad Library ad ~39
Get a single Google Ad Transparency creative by public Ad Transparency URL.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Public Google Ad Transparency URL for the creative. |
No output schema declared.
No examples provided.
google_adLibrary_advertisers_search Search Google Ad Library advertisers ~71
Search Google Ad Transparency advertisers by name. Accepts a advertiser name. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Search query text for Google Ad Transparency advertisers. |
| region | string | — | Two-letter country code to search in. Default: `US`. |
No output schema declared.
No examples provided.
google_company_ads_list List Google company ads ~187
List ads a company or advertiser is running in Google Ad Transparency. Accepts a domain or advertiser id. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| advertiserId | string | — | Google Ad Transparency advertiser id when you have it instead of a domain. |
| cursor | string | — | Opaque pagination cursor from a previous response. |
| domain | string | — | Company domain when you do not have an advertiser id. |
| endDate | string | — | Optional end date filter in YYYY-MM-DD format. |
| format | string | — | Optional creative format filter. |
| platform | string | — | Optional Google surface filter. |
| region | string | — | Optional region filter as a two-letter country code. |
| startDate | string | — | Optional start date filter in YYYY-MM-DD format. |
| topic | string | — | Optional topic filter. When `political`, `region` is required. |
No output schema declared.
No examples provided.
hackernews_comment_context_get Get Hacker News comment context ~42
Get a Hacker News comment with its ancestor chain to the root story. Accepts a comment id.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | Hacker News comment id. |
No output schema declared.
No examples provided.
hackernews_feed_list List a Hacker News feed ~108
List a Hacker News feed by type (top, new, best, ask, show, or jobs). Accepts a feed name. Returns a list (use offset/limit when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| feed | string | yes | Hacker News feed: top, new, best, ask, show, or jobs. |
| limit | integer | — | Maximum items to hydrate (1–50). Default: 30. |
| offset | integer | — | Zero-based offset into the official feed id list. |
No output schema declared.
No examples provided.
hackernews_item_get Get Hacker News item ~29
Get a Hacker News item by id.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | Hacker News item id. |
No output schema declared.
No examples provided.
hackernews_jobs_who_is_hiring_list List Who is Hiring jobs ~112
List top-level jobs from the monthly Hacker News Who is Hiring thread (latest thread, or a YYYY-MM month). Returns a list (use page/pageSize when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| month | string | — | Calendar month (YYYY-MM) to pin a Who is Hiring thread. Default: latest thread. |
| page | integer | — | Zero-based page index of top-level hiring comments. |
| pageSize | integer | — | Job rows per page (1–50). Default: 20. |
No output schema declared.
No examples provided.
hackernews_maxitem_get Get Hacker News max item id ~20
Get the current largest Hacker News item id.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
hackernews_search_list Search Hacker News ~384
Search Hacker News by keyword. Returns a list (use page/pageSize when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| author | string | — | Restrict results to items by this Hacker News username. |
| dateRange | string | — | Creation-time window. Default: `all`. |
| domain | string | — | Restrict search to story URLs matching this domain (e.g. example.com). Can omit `query`. |
| frontPageOnly | — | — | When true, restrict results to current front-page items. Allows omitting `query`. |
| minPoints | integer | — | Minimum points/score filter. |
| page | integer | — | Zero-based page index (maximum 50 pages, up to 1,000 hits). |
| pageSize | — | — | Hits per page. Must be one of 10, 20, 30, 50. Default: 20. |
| prefix | — | — | When true, enable prefix matching for query tokens. |
| query | string | — | Full-text search query. Required unless `frontPageOnly`, `author`, `domain`, or `url` is set. |
| searchAuthor | — | — | When true, include author username in the searchable fields. |
| searchStoryText | — | — | Include story/comment text in searchable fields. Default: true. Set false to search title/URL only. |
| sort | string | — | Ranking mode. Default: `popularity`. |
| type | string | — | Restrict search results to a Hacker News content type. `ask_hn`: Ask HN posts (questions to the community). `show_hn`: Show HN posts (projects/work being shared). `launch_hn`: Launch HN posts (YC-aff… |
| typoTolerance | — | — | Enable typo tolerance. Default: true. |
| url | string | — | Restrict search to story URLs matching this URL substring. Can omit `query`. |
No output schema declared.
No examples provided.
hackernews_story_comments_list Get Hacker News story comments ~94
List comments on a Hacker News story by id. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque continuation cursor from a previous response. Omit for the first page. |
| id | integer | yes | Hacker News story id whose comment tree should be returned. |
| limit | integer | — | Maximum comment nodes to return in this page (1–100). Default: 50. |
No output schema declared.
No examples provided.
hackernews_story_get Get Hacker News story ~29
Get a Hacker News story by id.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | Hacker News story id. |
No output schema declared.
No examples provided.
hackernews_updates_get Get Hacker News updates ~20
Get recently changed Hacker News item ids and usernames.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
hackernews_user_comments_list List Hacker News user comments ~96
List a Hacker News user's comments (newest first). Accepts a username. Returns a list (use page/pageSize when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | — | Zero-based page index (maximum 50 pages, up to 1,000 hits). |
| pageSize | integer | — | Hits per page (1–50). Default: 20. |
| username | string | yes | Hacker News username (case-sensitive). |
No output schema declared.
No examples provided.
hackernews_user_favorites_list List Hacker News user favorites ~74
List favorites for a Hacker News user by username. Returns a list (use page when paginated; 1-based).
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | — | One-based HTML favorites page number. Default: 1. Each page bills 1 credit. |
| username | string | yes | Hacker News username (case-sensitive). |
No output schema declared.
No examples provided.
hackernews_user_get Get Hacker News user profile ~32
Get a Hacker News user profile by username.
| Name | Type | Req | Description |
|---|---|---|---|
| username | string | yes | Hacker News username (case-sensitive). |
No output schema declared.
No examples provided.
hackernews_user_submissions_list List Hacker News user submissions ~102
List a Hacker News user's stories, polls, and jobs (newest first). Accepts a username. Returns a list (use page/pageSize when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | — | Zero-based page index (maximum 50 pages, up to 1,000 hits). |
| pageSize | integer | — | Hits per page (1–50). Default: 20. |
| username | string | yes | Hacker News username (case-sensitive). |
No output schema declared.
No examples provided.
instagram_highlight_get Get Instagram highlight ~37
Get stories inside a saved Instagram highlight by highlight id.
| Name | Type | Req | Description |
|---|---|---|---|
| highlightId | string | yes | Numeric Instagram highlight id from a highlight URL. |
No output schema declared.
No examples provided.
instagram_post_comments_list List Instagram post or reel comments ~69
List comments on an Instagram post or Reel by URL. Returns a list (use cursor when paginated).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Opaque cursor from a previous response to fetch the next page. |
| url | string | yes | Link to the Instagram post or reel whose comments should be listed. |
No output schema declared.
No examples provided.