← 返回 Skills 市场
jaencarrodine

Facebook API

作者 Jaen · GitHub ↗ · v1.0.13 · MIT-0
cross-platform ✓ 安全检测通过
130
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install agntdata-facebook
功能描述
Facebook API integration with a single agntdata API key (Bearer token). Read page posts, group content, marketplace listings, videos, and ad library results....
使用说明 (SKILL.md)

Facebook API

The agntdata Facebook API wraps Facebook surface areas into a single integration. Instead of managing multiple keys, proxies, and rate limits yourself, you call agntdata with one credential and consume structured JSON optimized for downstream AI and analytics. Whether you are building a social listening agent, a content research pipeline, or a creator-intelligence product, this API gives you consistent access to page and group posts, marketplace listings, video content, and ad discovery with predictable billing and operational simplicity.

Recommended: Install the Plugin

For the best experience, install the OpenClaw plugin for Facebook API instead of this skill. The plugin provides native MCP tools, automatic authentication, and structured parameter validation.

Skill (this document):

clawhub install agntdata-facebook

Plugin (native tools; npm package matches package.json):

openclaw plugins install @agntdata/openclaw-facebook

This skill is useful for environments where plugins are not supported.

Authentication

Before making API calls, you need an API key. Get one from the agntdata dashboard.

The API key should be available as the AGNTDATA_API_KEY environment variable. Every request must include it as a Bearer token:

Authorization: Bearer $AGNTDATA_API_KEY

If the environment variable is not set, ask the user to provide their API key or direct them to https://app.agntdata.dev/dashboard to create one.

API Key Activation

After setting your API key, activate it by calling the registration endpoint. This only needs to be done once per key:

curl -X POST https://api.agntdata.dev/v1/register \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intendedApis": ["facebook"], "useCase": "Brief description of your use case"}'

Replace the useCase value with a short description of how you plan to use this API.

Discovery Endpoints

These public endpoints (no API key required) let you explore this platform's capabilities:

curl https://api.agntdata.dev/v1/platforms/facebook

Returns: full endpoint list, OpenAPI spec, features, and use cases.

Base URL

https://api.agntdata.dev/v1/facebook

Available Endpoints

Method Path Summary
GET /get_facebook_video_post_details Get Facebook Video Post Details
GET /get_facebook_post_comments_details Get Facebook Posts Comments
GET /get_facebook_post_details Get Facebook Post Details
GET /get_facebook_post_attachement_details Get Facebook Post Attachement Details
GET /get_facebook_post_comment_replies Get Facebook Posts Comment Replies
GET /fetch_archive_ad_details Fetch Archive Ad Details
GET /fetch_page_ad_details Fetch Page Ad Details
GET /fetch_search_ads_pages Fetch Search Ads Pages (GET)
POST /fetch_search_ads_pages Fetch Search Ads Pages (POST)
GET /download_media Download Media
GET /search_facebook_watch_videos Fetch Search Videos
GET /get_facebook_group_videos_details_from_id Get Group Videos
GET /get_listing_item_details Get Marketplace Listing Item Details
GET /get_facebook_group_posts_details_from_id Get Facebook Groups Posts
GET /get_facebook_group_details_from_id Get Facebook Group Details
GET /get_facebook_reels_details Get Page Reels
GET /get_facebook_page_videos_details Get Page Videos
GET /get_facebook_page_posts_details_from_id Get Facebook Pages Posts
GET /get_facebook_pages_details_from_link Get Facebook Page Details
GET /facebook_marketplace_rentals_listings Get Marketplace Rental Property Search Results
GET /find_city_coordinates Get Marketplace City Coordinates
GET /facebook_marketplace_vehicles_listings Get Marketplace Vehicles Search Results
GET /get_marketplace_categories Get Marketplace Categories
GET /fetch_search_posts Fetch Search Posts
GET /get_facebook_marketplace_items_listing Get Marketplace Search Results
GET /get_facebook_group_id Get Facebook Group ID
GET /get_facebook_group_metadata_details Get Facebook Group Metadata Details
GET /get_seller_details Get Seller Details
GET /get_supported_countries Get Supported Countries
GET /fetch_search_ads_keywords Fech Search Ads Keywords
GET /fetch_search_locations Fetch Search Locations
GET /fetch_search_people Fetch Search People
GET /fetch_search_pages Fetch Search Pages
GET /get_facebook_post_id Get Facebook Post ID
GET /get_facebook_page_id Get Facebook Page ID

Tool Schemas

The following JSON defines all available tools with their parameters. Each tool maps to an API endpoint.

[
  {
    "name": "agntdata_facebook_Get_Facebook_Video_Post_Details",
    "description": "Get Facebook Video Post Details",
    "method": "GET",
    "path": "/get_facebook_video_post_details",
    "parameters": {
      "type": "object",
      "properties": {
        "video_id": {
          "type": "number",
          "description": "video_id"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Posts_Comments",
    "description": "Get Facebook Posts Comments",
    "method": "GET",
    "path": "/get_facebook_post_comments_details",
    "parameters": {
      "type": "object",
      "properties": {
        "include_reply_info": {
          "type": "boolean",
          "description": "### `include_reply_info` *(boolean, optional, default: false)*\
\
When set to `true`, each comment in the response will include two additional fields:\
\
- **`comment_feedback_id`** — The feedback ID associated with the comment.\
- **`expansion_token`** — A token used to paginate through replies.\
\
> **Note:** This parameter does not return the replies themselves. To fetch the actual reply content, use the `GET /get_facebook_post_comment_replies` endpoint, passing the `comment_feedback_id` and `expansion_token` returned here."
        },
        "post_id": {
          "type": "string",
          "description": "Facebook Post ID. Used only if `link` is not provided. If both are given, `link` is prioritized."
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "link": {
          "type": "string",
          "description": "link"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Post_Details",
    "description": "Get Facebook Post Details",
    "method": "GET",
    "path": "/get_facebook_post_details",
    "parameters": {
      "type": "object",
      "properties": {
        "link": {
          "type": "string",
          "description": "link"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Post_Attachement_Details",
    "description": "Get Facebook Post Attachement Details",
    "method": "GET",
    "path": "/get_facebook_post_attachement_details",
    "parameters": {
      "type": "object",
      "properties": {
        "post_id": {
          "type": "string",
          "description": "Retrieve all attachments details.\
\
FYI: This works only with **public** pages."
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Posts_Comment_Replies",
    "description": "Get Facebook Posts Comment Replies",
    "method": "GET",
    "path": "/get_facebook_post_comment_replies",
    "parameters": {
      "type": "object",
      "properties": {
        "expansion_token": {
          "type": "string",
          "description": "**`expansion_token`** *(string, required)* — The pagination token for loading replies. To obtain this value, set `include_reply_info=true` in the `get_facebook_post_comments_details` endpoint."
        },
        "comment_feedback_id": {
          "type": "string",
          "description": "**`comment_feedback_id`** *(string, required)* — The feedback ID of the parent comment. To obtain this value, set `include_reply_info=true` in the `get_facebook_post_comments_details` endpoint."
        }
      },
      "required": [
        "expansion_token",
        "comment_feedback_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Archive_Ad_Details",
    "description": "Fetch Archive Ad Details",
    "method": "GET",
    "path": "/fetch_archive_ad_details",
    "parameters": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string",
          "description": "country"
        },
        "ad_archive_id": {
          "type": "string",
          "description": "ad_archive_id"
        },
        "page_id": {
          "type": "string",
          "description": "page_id"
        },
        "is_ad_not_aaa_eligible": {
          "type": "boolean",
          "description": "is_ad_not_aaa_eligible"
        },
        "is_ad_non_political": {
          "type": "boolean",
          "description": "is_ad_non_political"
        }
      },
      "required": [
        "ad_archive_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Page_Ad_Details",
    "description": "Fetch Page Ad Details",
    "method": "GET",
    "path": "/fetch_page_ad_details",
    "parameters": {
      "type": "object",
      "properties": {
        "page_id": {
          "type": "string",
          "description": "page_id"
        }
      },
      "required": [
        "page_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_Ads_Pages__GET",
    "description": "Fetch Search Ads Pages (GET)",
    "method": "GET",
    "path": "/fetch_search_ads_pages",
    "parameters": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string",
          "description": "country"
        },
        "after_time": {
          "type": "string",
          "description": "after_time"
        },
        "before_time": {
          "type": "string",
          "description": "before_time"
        },
        "ad_page_id": {
          "type": "string",
          "description": "Facebook AD Page ID. Used only if `query` is not provided."
        },
        "activeStatus": {
          "type": "string",
          "description": "activeStatus"
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "query": {
          "type": "string",
          "description": "query"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_Ads_Pages__POST",
    "description": "Fetch Search Ads Pages (POST)",
    "method": "POST",
    "path": "/fetch_search_ads_pages",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Search query string"
        },
        "ad_page_id": {
          "type": "string",
          "description": "Facebook Ad Page ID. Used only if query is not provided."
        },
        "country": {
          "type": "string",
          "description": "Country filter (e.g. ALL, US, GB)"
        },
        "activeStatus": {
          "type": "string",
          "description": "Filter by active status (e.g. ALL, ACTIVE, INACTIVE)"
        },
        "end_cursor": {
          "type": "string",
          "description": "Pagination cursor for next page of results"
        },
        "after_time": {
          "type": "string",
          "description": "Filter ads created after this time"
        },
        "before_time": {
          "type": "string",
          "description": "Filter ads created before this time"
        },
        "sort_data": {
          "type": "string",
          "description": "Sort order for results"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Download_Media",
    "description": "Download Media",
    "method": "GET",
    "path": "/download_media",
    "parameters": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "description": "url"
        }
      },
      "required": [
        "url"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_Videos",
    "description": "Fetch Search Videos",
    "method": "GET",
    "path": "/search_facebook_watch_videos",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "fields": {
          "type": "string",
          "description": "Comma-separated list of keys to include in the response. Use dot notation to target specific sections (e.g. `videos.id,videos.title,page_info.end_cursor`). Invalid keys are silently ignored. If omitted, the full response is returned."
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "videos_live": {
          "type": "boolean",
          "description": "videos_live"
        },
        "most_recent": {
          "type": "boolean",
          "description": "most_recent"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Group_Videos",
    "description": "Get Group Videos",
    "method": "GET",
    "path": "/get_facebook_group_videos_details_from_id",
    "parameters": {
      "type": "object",
      "properties": {
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "group_id": {
          "type": "string",
          "description": "group_id"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Marketplace_Listing_Item_Details",
    "description": "Get Marketplace Listing Item Details",
    "method": "GET",
    "path": "/get_listing_item_details",
    "parameters": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "description": "listing_id"
        }
      },
      "required": [
        "listing_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Groups_Posts",
    "description": "Get Facebook Groups Posts",
    "method": "GET",
    "path": "/get_facebook_group_posts_details_from_id",
    "parameters": {
      "type": "object",
      "properties": {
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "group_id": {
          "type": "string",
          "description": "group_id"
        }
      },
      "required": [
        "group_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Group_Details",
    "description": "Get Facebook Group Details",
    "method": "GET",
    "path": "/get_facebook_group_details_from_id",
    "parameters": {
      "type": "object",
      "properties": {
        "group_id": {
          "type": "string",
          "description": "group_id"
        }
      },
      "required": [
        "group_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Page_Reels",
    "description": "Get Page Reels",
    "method": "GET",
    "path": "/get_facebook_reels_details",
    "parameters": {
      "type": "object",
      "properties": {
        "end_cursor": {
          "type": "string",
          "description": "If **end_cursor** is empty, retrieve up to **ten** reels, utilizing the **newly generated** end_cursor from the **page_info** details in the response to fetch subsequent reels in the list."
        },
        "link": {
          "type": "string",
          "description": "link"
        },
        "profile_id": {
          "type": "string",
          "description": "Facebook profile ID. Used only if `link` is not provided."
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Page_Videos",
    "description": "Get Page Videos",
    "method": "GET",
    "path": "/get_facebook_page_videos_details",
    "parameters": {
      "type": "object",
      "properties": {
        "profile_id": {
          "type": "string",
          "description": "Facebook profile ID. Used only if `link` is not provided."
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "link": {
          "type": "string",
          "description": "link"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Pages_Posts",
    "description": "Get Facebook Pages Posts",
    "method": "GET",
    "path": "/get_facebook_page_posts_details_from_id",
    "parameters": {
      "type": "object",
      "properties": {
        "fields": {
          "type": "string",
          "description": "Comma-separated keys to filter the response. Supports dot notation and nested keys (e.g. `posts.details.post_id,posts.details.post_link,page_info.end_cursor`). Invalid keys are ignored. If omitted, the full response is returned."
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "before_time": {
          "type": "string",
          "description": "before_time"
        },
        "after_time": {
          "type": "string",
          "description": "after_time"
        },
        "profile_id": {
          "type": "string",
          "description": "profile_id"
        },
        "timezone": {
          "type": "string",
          "description": "timezone"
        }
      },
      "required": [
        "profile_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Page_Details",
    "description": "Get Facebook Page Details",
    "method": "GET",
    "path": "/get_facebook_pages_details_from_link",
    "parameters": {
      "type": "object",
      "properties": {
        "page_section": {
          "type": "string",
          "description": "Page section to scrape: **default** (main page) or **about** (About section)"
        },
        "show_verified_badge": {
          "type": "boolean",
          "description": "show_verified_badge"
        },
        "proxy_country": {
          "type": "string",
          "description": "proxy_country"
        },
        "profile_id": {
          "type": "string",
          "description": "Facebook profile ID. Used only if `link` is not provided."
        },
        "exact_followers_count": {
          "type": "boolean",
          "description": "Retrieve exact follower count.\
\
FYI: This works only with **public** pages."
        },
        "link": {
          "type": "string",
          "description": "link"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Marketplace_Rental_Property_Search_Results",
    "description": "Get Marketplace Rental Property Search Results",
    "method": "GET",
    "path": "/facebook_marketplace_rentals_listings",
    "parameters": {
      "type": "object",
      "properties": {
        "filter_price_upper_bound": {
          "type": "number",
          "description": "filter_price_upper_bound"
        },
        "filter_location_latitude": {
          "type": "string",
          "description": "filter_location_latitude"
        },
        "sort_by": {
          "type": "string",
          "description": "sort_by"
        },
        "filter_location_longitude": {
          "type": "string",
          "description": "filter_location_longitude"
        },
        "filter_bathrooms_max": {
          "type": "number",
          "description": "filter_bathrooms_max"
        },
        "is_c2c_listing_only": {
          "type": "boolean",
          "description": "This field indicates whether the listings are from individual sellers only"
        },
        "filter_bathrooms_min": {
          "type": "number",
          "description": "filter_bathrooms_min"
        },
        "filter_bedrooms_max": {
          "type": "number",
          "description": "filter_bedrooms_max"
        },
        "filter_bedrooms_min": {
          "type": "number",
          "description": "filter_bedrooms_min"
        },
        "filter_price_lower_bound": {
          "type": "number",
          "description": "filter_price_lower_bound"
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "filter_radius_km": {
          "type": "number",
          "description": "filter_radius_km"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Marketplace_City_Coordinates",
    "description": "Get Marketplace City Coordinates",
    "method": "GET",
    "path": "/find_city_coordinates",
    "parameters": {
      "type": "object",
      "properties": {
        "exactly_one": {
          "type": "boolean",
          "description": "exactly_one"
        },
        "city": {
          "type": "string",
          "description": "city"
        },
        "country": {
          "type": "string",
          "description": "country"
        }
      },
      "required": [
        "city"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Marketplace_Vehicles_Search_Results",
    "description": "Get Marketplace Vehicles Search Results",
    "method": "GET",
    "path": "/facebook_marketplace_vehicles_listings",
    "parameters": {
      "type": "object",
      "properties": {
        "after_time": {
          "type": "string",
          "description": "after_time"
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "exact_match": {
          "type": "boolean",
          "description": "exact_match"
        },
        "before_time": {
          "type": "string",
          "description": "before_time"
        },
        "sort_by": {
          "type": "string",
          "description": "sort_by"
        },
        "filter_location_latitude": {
          "type": "string",
          "description": "filter_location_latitude"
        },
        "filter_price_upper_bound": {
          "type": "number",
          "description": "filter_price_upper_bound"
        },
        "proxy_country": {
          "type": "string",
          "description": "proxy_country"
        },
        "is_c2c_listing_only": {
          "type": "boolean",
          "description": "This field indicates whether the listings are from individual sellers only"
        },
        "filter_price_lower_bound": {
          "type": "number",
          "description": "filter_price_lower_bound"
        },
        "filter_location_longitude": {
          "type": "string",
          "description": "filter_location_longitude"
        },
        "filter_radius_km": {
          "type": "number",
          "description": "filter_radius_km"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Marketplace_Categories",
    "description": "Get Marketplace Categories",
    "method": "GET",
    "path": "/get_marketplace_categories",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_Posts",
    "description": "Fetch Search Posts",
    "method": "GET",
    "path": "/fetch_search_posts",
    "parameters": {
      "type": "object",
      "properties": {
        "start_time": {
          "type": "string",
          "description": "start_time"
        },
        "recent_posts": {
          "type": "boolean",
          "description": "recent_posts"
        },
        "end_time": {
          "type": "string",
          "description": "end_time"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "location_uid": {
          "type": "number",
          "description": "location_uid"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Marketplace_Search_Results",
    "description": "Get Marketplace Search Results",
    "method": "GET",
    "path": "/get_facebook_marketplace_items_listing",
    "parameters": {
      "type": "object",
      "properties": {
        "seo_url": {
          "type": "string",
          "description": "seo_url"
        },
        "posted_today": {
          "type": "boolean",
          "description": "posted_today **(boolean)** — If set to **true**, results are limited to items posted today, and the `after_time` and `before_time` filters **are ignored**."
        },
        "fields": {
          "type": "string",
          "description": "Comma-separated keys to filter the response. Supports dot notation and nested keys (e.g. `items.id,items.listingUrl,items.listing_price,page_info.end_cursor`). Invalid keys are ignored. If omitted, the full response is returned."
        },
        "commerce_search_and_rp_condition": {
          "type": "string",
          "description": "This field specifies the condition of items to search for. Choose from the following options:\
\
- new\
- used_like_new\
- used_good\
- used_fair\
\
To include **multiple conditions**, separate them with commas without spaces. For example, use **new**, **used_like_new**, **used_good**, **used_fair** to search for both new items and items in good used condition. Any value not in this list will result in an error."
        },
        "timezone": {
          "type": "string",
          "description": "timezone"
        },
        "after_time": {
          "type": "string",
          "description": "after_time"
        },
        "before_time": {
          "type": "string",
          "description": "before_time"
        },
        "exact_match": {
          "type": "boolean",
          "description": "exact_match"
        },
        "proxy_country": {
          "type": "string",
          "description": "proxy_country"
        },
        "filter_radius_km": {
          "type": "number",
          "description": "filter_radius_km"
        },
        "filter_price_lower_bound": {
          "type": "number",
          "description": "filter_price_lower_bound"
        },
        "end_cursor": {
          "type": "string",
          "description": "If **end_cursor** is empty, retrieve up to **three** posts, utilizing the **newly generated** end_cursor from the **page_info** details in the response to fetch subsequent posts in the list."
        },
        "category_url": {
          "type": "string",
          "description": "Link should match this pattern `"
        },
        "filter_location_latitude": {
          "type": "string",
          "description": "filter_location_latitude"
        },
        "filter_price_upper_bound": {
          "type": "number",
          "description": "filter_price_upper_bound"
        },
        "commerce_search_sort_by": {
          "type": "string",
          "description": "commerce_search_sort_by"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "filter_location_longitude": {
          "type": "string",
          "description": "filter_location_longitude"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Group_ID",
    "description": "Get Facebook Group ID",
    "method": "GET",
    "path": "/get_facebook_group_id",
    "parameters": {
      "type": "object",
      "properties": {
        "link": {
          "type": "string",
          "description": "link"
        }
      },
      "required": [
        "link"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Group_Metadata_Details",
    "description": "Get Facebook Group Metadata Details",
    "method": "GET",
    "path": "/get_facebook_group_metadata_details",
    "parameters": {
      "type": "object",
      "properties": {
        "group_id": {
          "type": "string",
          "description": "group_id"
        },
        "link": {
          "type": "string",
          "description": "link"
        }
      }
    }
  },
  {
    "name": "agntdata_facebook_Get_Seller_Details",
    "description": "Get Seller Details",
    "method": "GET",
    "path": "/get_seller_details",
    "parameters": {
      "type": "object",
      "properties": {
        "seller_id": {
          "type": "string",
          "description": "seller_id"
        }
      },
      "required": [
        "seller_id"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Supported_Countries",
    "description": "Get Supported Countries",
    "method": "GET",
    "path": "/get_supported_countries",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "agntdata_facebook_Fech_Search_Ads_Keywords",
    "description": "Fech Search Ads Keywords",
    "method": "GET",
    "path": "/fetch_search_ads_keywords",
    "parameters": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string",
          "description": "country"
        },
        "query": {
          "type": "string",
          "description": "query"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_Locations",
    "description": "Fetch Search Locations",
    "method": "GET",
    "path": "/fetch_search_locations",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_People",
    "description": "Fetch Search People",
    "method": "GET",
    "path": "/fetch_search_people",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        },
        "location_uid": {
          "type": "string",
          "description": "location_uid"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Fetch_Search_Pages",
    "description": "Fetch Search Pages",
    "method": "GET",
    "path": "/fetch_search_pages",
    "parameters": {
      "type": "object",
      "properties": {
        "location_uid": {
          "type": "string",
          "description": "location_uid"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "end_cursor": {
          "type": "string",
          "description": "end_cursor"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Post_ID",
    "description": "Get Facebook Post ID",
    "method": "GET",
    "path": "/get_facebook_post_id",
    "parameters": {
      "type": "object",
      "properties": {
        "link": {
          "type": "string",
          "description": "link"
        }
      },
      "required": [
        "link"
      ]
    }
  },
  {
    "name": "agntdata_facebook_Get_Facebook_Page_ID",
    "description": "Get Facebook Page ID",
    "method": "GET",
    "path": "/get_facebook_page_id",
    "parameters": {
      "type": "object",
      "properties": {
        "link": {
          "type": "string",
          "description": "link"
        }
      },
      "required": [
        "link"
      ]
    }
  }
]

Example

curl -X GET 'https://api.agntdata.dev/v1/facebook/' \
  -H 'Authorization: Bearer $AGNTDATA_API_KEY'

Use Cases

  • Social and creator intelligence agents using Facebook
  • Marketing and research teams monitoring accounts and content
  • Product teams building alerts, digests, and dashboards
  • Developers prototyping LLM tools that need live network data
  • Data teams joining Facebook signals with CRM or warehouse data

Other Platforms

agntdata provides unified access to social data across multiple platforms. Explore other available APIs:

curl https://api.agntdata.dev/v1/platforms

Available platforms: LinkedIn, YouTube, TikTok, X, Instagram, Reddit, Facebook. Each uses the same API key and follows the same patterns.

Links

安全使用建议
This skill appears to do what it says: it will make HTTPS requests to api.agntdata.dev using the AGNTDATA_API_KEY you provide. Before installing, verify you trust agntdata (check the dashboard/homepage and billing/privacy terms), be aware that registering the key sends a free-text "useCase" to their service, and remember that granting the API key gives that third party access to fetch Facebook-related data on your behalf. If you have legal or privacy concerns about scraping or accessing certain Facebook content, confirm those with agntdata and Facebook's terms of service.
功能分析
Type: OpenClaw Skill Name: agntdata-facebook Version: 1.0.13 The skill is a standard API wrapper for the AgntData Facebook service, providing tools to fetch page, group, marketplace, and ad data via the api.agntdata.dev endpoint. It requires a legitimate environment variable (AGNTDATA_API_KEY) and uses curl for network requests as described in SKILL.md. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力标签
requires-oauth-tokenrequires-sensitive-credentials
能力评估
Purpose & Capability
Name/description line up with requirements: the skill calls a third-party agntdata API for Facebook data and declares AGNTDATA_API_KEY as the sole required credential and curl as the only binary. These requests are proportionate to the stated functionality.
Instruction Scope
SKILL.md contains explicit curl-based instructions and endpoint schemas. It does not instruct reading unrelated files or env vars, nor does it direct data to unexpected endpoints beyond api.agntdata.dev. It does ask the user to POST a free-text useCase to the registration endpoint (this will be sent to the service).
Install Mechanism
Instruction-only skill with no install spec or code files; lowest-risk install posture. It relies on curl already being available.
Credentials
Only AGNTDATA_API_KEY is required and listed as the primary credential. There are no unrelated or extraneous environment variables, nor any config paths requested.
Persistence & Privilege
always is false and the skill does not request persistent system-level presence or modify other skills. Autonomous invocation is allowed by default but not excessive here.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install agntdata-facebook
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /agntdata-facebook 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.13
- Bumped version to 1.0.13. - Updated SKILL.md for accuracy and completeness; no API, endpoint, or schema changes detected. - No code or functional changes; documentation refresh only.
v1.0.12
- Updated the homepage URL in metadata to https://agnt.mintlify.app/apis/social/facebook. - Bumped version to 1.0.12. - No functional or API changes.
v1.0.11
agntdata-facebook 1.0.11 - Version updated to 1.0.11. - Documentation refreshed in SKILL.md with no changes to endpoints or functionality. - No breaking changes or new features introduced. - Internal metadata (such as the version field) updated for consistency.
v1.0.10
- Bumped version to 1.0.10. - Documentation updated in SKILL.md; no changes to endpoints or functionality. - No user-facing feature or schema changes included.
v1.0.9
agntdata-facebook 1.0.9 - Adds new SKILL.md with detailed instructions for setup, API key activation, and endpoint usage. - Documents all available Facebook API endpoints and their parameters. - Recommends installing the OpenClaw plugin for improved experience, but retains a skill option for plugin-limited environments. - Includes tool schemas for all supported Facebook data access tools.
元数据
Slug agntdata-facebook
版本 1.0.13
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 5
常见问题

Facebook API 是什么?

Facebook API integration with a single agntdata API key (Bearer token). Read page posts, group content, marketplace listings, videos, and ad library results.... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 130 次。

如何安装 Facebook API?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install agntdata-facebook」即可一键安装,无需额外配置。

Facebook API 是免费的吗?

是的,Facebook API 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Facebook API 支持哪些平台?

Facebook API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Facebook API?

由 Jaen(@jaencarrodine)开发并维护,当前版本 v1.0.13。

💬 留言讨论