# Misskey & Fediverse Influencer & Content Intelligence (`straightforward_hydra/misskey-fediverse-intelligence`) Actor

Discover influencers, enrich accounts, scrape notes, hashtags & trends on Misskey, Sharkey, Foundkey, Iceshrimp and Firefish. No key.

- **URL**: https://apify.com/straightforward\_hydra/misskey-fediverse-intelligence.md
- **Developed by:** [Dev D](https://apify.com/straightforward_hydra) (community)
- **Categories:** Social media, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Misskey & Fediverse Influencer & Content Intelligence 🌐

**Discover influencers, enrich accounts, scrape notes + engagement, pull hashtag/keyword content and trending tags from any Misskey-family instance — no API key, no proxy.**

Works on **Misskey, Sharkey, Foundkey, Iceshrimp and Firefish** — they share the Misskey public API. Point it at any instance (default `misskey.io`, the huge Japanese network) and pull clean, structured data.

Perfect for **social listening, creator/influencer discovery, community & brand monitoring, and Fediverse research**.

> Uses each instance's public API — no key, no login. Sibling actor exists for Mastodon / Pleroma / Pixelfed.

***

### Modes

| Mode | What you get |
|---|---|
| **Discover influencers** | Rank accounts by a hashtag or name query, sorted by followers (optional engagement). |
| **Enrich accounts** | Full profile for each handle: followers, following, notes, bio, bot flag. |
| **Account notes** | A handle's recent notes with engagement. |
| **Hashtag notes** | All notes for a hashtag. |
| **Keyword search** | Notes matching a keyword. |
| **Trending hashtags** | The instance's current trending tags. |

### Input

| Field | Description |
|---|---|
| **Instance** | Instance host, e.g. `misskey.io`, `misskey.design`. |
| **Mode** | One of the modes above. |
| **Hashtag** | Tag (without `#`) for discover / hashtag modes. |
| **Query** | Name query (discover) or keyword (search). |
| **Handles** | Usernames for accounts / posts modes. Local `art`; remote (federated) `user@host`, e.g. `Gargron@mastodon.social`. |
| **Include engagement** | Sample recent notes → avg renotes/replies/reactions + engagement score. |
| **Max results** | Cap on items returned. |

#### Example — top #art creators on misskey.io, with engagement

```json
{
  "instance": "misskey.io",
  "mode": "discover",
  "hashtag": "art",
  "includeEngagement": true,
  "maxResults": 50
}
```

### Output (account)

```json
{
  "rank": 1,
  "handle": "The_Nerdy_Neko@vt.social",
  "name": "…",
  "followers_count": 12000,
  "following_count": 800,
  "notes_count": 34000,
  "bio": "…",
  "is_bot": false,
  "created_at": "2023-02-06T07:14:32.968Z",
  "url": "https://misskey.io/@art",
  "avg_reactions": 14.2,
  "engagement_score": 21.0,
  "instance": "misskey.io"
}
```

### Output (note)

```json
{
  "id": "aou4uftb7eoo00yn",
  "user_handle": "someone",
  "text": "Cloud cat ☁️🐾 #art",
  "renote_count": 3,
  "replies_count": 1,
  "reaction_count": 12,
  "tags": ["art", "digitalart"],
  "visibility": "public",
  "created_at": "2026-07-18T16:15:40.943Z",
  "url": "https://misskey.io/notes/aou4uftb7eoo00yn",
  "instance": "misskey.io"
}
```

### Notes & limitations

- Public reads only; private/follower-only notes are not returned.
- **Discover** ranks the accounts most active on the topic by real follower count. It also returns `topic_notes` — a within-scan activity/engagement signal that works regardless of federation.
- **Federation note:** for a *remote* account, `followers_count` reflects only what the queried instance has cached (it can undercount). Point the actor at the instance where an account lives for its true count, or use `topic_notes` as an instance-independent signal.
- Large hashtag/keyword scans page in small batches (big instances rate-limit heavy queries); a transient server timeout is retried and skipped gracefully.
- Remote (federated) accounts are looked up via `user@host`.
- Data source: the instance's public Misskey API. Sibling actors exist for Mastodon/Pleroma/Pixelfed, Bluesky, Lemmy and PeerTube.

***

#### Keywords

Misskey, Sharkey, Firefish, Iceshrimp, Fediverse, ActivityPub, social media scraper, influencer discovery, social listening, hashtag scraper, notes, microblog, misskey.io, community intelligence, creator analytics, engagement, trending hashtags, no key, decentralized social.

# Actor input Schema

## `instance` (type: `string`):

Misskey-family instance host, e.g. "misskey.io", "misskey.design".

## `mode` (type: `string`):

discover = rank influencers by hashtag or name; accounts = enrich handles; posts = a handle's notes; hashtag = notes for a tag; search = notes for a keyword; trending = trending hashtags.

## `hashtag` (type: `string`):

Hashtag (without #) for discover / hashtag modes, e.g. "art", "photography".

## `query` (type: `string`):

Name query (discover) or keyword (search mode).

## `handles` (type: `array`):

Usernames for accounts / posts modes. Local: "art". Remote (federated): "user@host", e.g. "Gargron@mastodon.social".

## `includeEngagement` (type: `boolean`):

For discover / accounts: sample recent notes and compute avg renotes/replies/reactions + an engagement score.

## `engagementSampleSize` (type: `integer`):

How many recent notes to sample per account for engagement.

## `maxResults` (type: `integer`):

Maximum number of items to return.

## Actor input object example

```json
{
  "instance": "misskey.io",
  "mode": "discover",
  "includeEngagement": false,
  "engagementSampleSize": 20,
  "maxResults": 100
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "instance": "misskey.io"
};

// Run the Actor and wait for it to finish
const run = await client.actor("straightforward_hydra/misskey-fediverse-intelligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "instance": "misskey.io" }

# Run the Actor and wait for it to finish
run = client.actor("straightforward_hydra/misskey-fediverse-intelligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "instance": "misskey.io"
}' |
apify call straightforward_hydra/misskey-fediverse-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=straightforward_hydra/misskey-fediverse-intelligence",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/szxT4AKbQekztGy6A/builds/M8MykyPDxOyuocmOV/openapi.json